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Avant-propos 



Pourquoi Qt ? Pourquoi des programmeurs comme nous en viennent-ils a choisir Qt ? 
Bien entendu, les reponses sont evidentes : la compatibility de Qt, les nombreuses fonc- 
tionnalites, les performances du C++, la disponibilite du code source, la documentation, 
le support technique de grande qualite et tous les autres elements mentionnes dans les 
documents marketing de Trolltech. Pour finir, voici l'aspect le plus important : Qt 
rencontre un tel succes, parce que les programmeurs Vapprecient. 

Pourquoi des programmeurs vont-ils apprecier une technologie et pas une autre ? Je 
pense personnellement que les ingenieurs logiciel aiment une technologie qui semble 
bonne, mais n'apprecient pas celles qui ne le sont pas. "Bonne" dans ce cas peut avoir 
diverses significations. Dans l'edition Qt 3 du livre, j'ai evoque le systeme telephonique 
de Trolltech comme etant un exemple particulierement bon d'une technologie particu- 
lierement mauvaise. Le systeme telephonique n'etait pas bon, parce qu'il nous obligeait 
a effectuer des taches apparemment aleatoires qui dependaient d'un contexte egalement 
aleatoire. Le hasard n'est pas une bonne chose. La repetition et la redondance sont 
d' autres aspects qui ne sont pas bons non plus. Les bons programmeurs sont faineants. 
Ce que nous aimons dans l'informatique par rapport au jardinage par exemple, c'est que 
nous ne sommes pas contraints de faire continuellement les memes choses. 

Laissez-moi approfondir sur ce point a l'aide d'un exemple issu du monde reel : les 
notes de frais. En general, ces notes de frais se presentent sous forme de tableurs 
complexes ; vous les remplissez et vous recevez votre argent en retour. Technologie 
simple me direz-vous. De plus, vu l'incitation pecuniaire, cela devrait constituer une 
tache aisee pour un ingenieur experiments . 

Toutefois, la realite est bien differente. Alors que personne d'autre dans l'entreprise ne 
semble avoir de soucis pour remplir ces formulaires, les ingenieurs en ont. Et pour en 
avoir discute avec des salaries d' autres entreprises, cela parait etre un comportement 
commun. Nous repoussons le remboursement jusqu'au dernier moment, et il arrive 
meme parfois que nous l'oublions. Pourquoi ? Au vu de notre formulaire, c'est une 
procedure standard simple. La personne doit rassembler les recus, les numeroter et inserer 
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ces numeros dans les champs appropries avec la date, l'endroit, une description et le montant. 
La numerotation et la copie sont concues pour faciliter la tache, mais ce sont des operations 
redondantes, sachant que la date, l'endroit, la description et le montant identifient sans aucun doute 
un recu. On pourrait penser qu'il s'agit d'un bien petit travail pour obtenir un remboursement. 

Le tarif journalier qui depend du lieu de sejour est quelque peu embarrassant. II existe des 
documents quelque part qui repertorient les tarifs normalises pour les divers lieux de sejour. 
Vous ne pouvez pas simplement choisir "Chicago" ; vous devez rechercher le tarif correspon- 
dant a Chicago vous-meme. II en va de meme pour le champ correspondant au taux de change. 
La personne doit trouver le taux de change en vigueur- peut-etre a l'aide de Google - puis 
saisir le taux dans chaque champ. En clair, vous devez attendre que votre banque vous fasse 
parvenir une lettre dans laquelle ils vous informent du taux de change applique. Meme si 
l'operation ne s'avere pas tres compliquee, il n'est pas commode de rechercher toutes ces 
informations dans differentes sources, puis de les recopier a plusieurs endroits dans le formu- 
laire. 

La programmation peut enormement ressembler a ces notes de frais, mais en pire. Et c'est la 
que Qt vient a votre rescousse. Qt est different. D'un cote, Qt est logique. D'un autre, Qt est 
amusant. Qt vous permet de vous concentrer sur vos taches. Quand les architectes de Qt 
rencontraient un probleme, ils ne cherchaient pas uniquement une solution convenable ou la 
solution la plus simple. Ils recherchaient la bonne solution, puis l'expliquaient. C'est vrai 
qu'ils faisaient des erreurs et que certaines de leurs decisions de conception ne resistaient pas 
au temps, mais ils proposaient quand meme beaucoup de bonnes choses et les mauvais cotes 
pouvaient toujours etre ameliores. Imaginez qu'un systeme concu a l'origine pour mettre en 
relation Windows 95 et Unix/Motif unifie desormais des systemes de bureau modernes aussi 
divers que Windows XP, Mac OS X et GNU/Linux, et pose les fondements de la plate -forme 
applicative Qtopia pour Linux Embarque. 

Bien avant que Qt ne devienne ce produit si populaire et si largement utilise, la devotion avec 
laquelle les developpeurs de ce framework recherchaient les bonnes solutions rendait Qt vraiment 
particulier. Ce devouement est toujours aussi fort aujourd'hui et affecte quiconque developpe 
et assure la maintenance de Qt. Pour nous, travailler avec Qt constitue une grande responsa- 
bilite et un privilege. Nous sommes fiers de contribuer a rendre vos existences professionnelles 
et open source plus simples et plus agreables. 

Matthias Ettrich 
Oslo, Norvege 
Juin 2006 



Preface 



Qt est un framework C++ permettant de developper des applications GUI multiplates- 
formes en se basant sur l'approche suivante : "Ecrire une fois, compiler n'importe ou." 
Qt permet aux programmeurs d' employer une seule arborescence source pour des appli- 
cations qui s'executeront sous Windows 98 a XP, Mac OS X, Linux, Solaris, HP-UX, et 
de nombreuses autres versions d'Unix avec XI 1. Les bibliotheques et outils Qt font 
egalement partie de Qtopia Core, un produit qui propose son propre systeme de fene- 
trage au-dessus de Linux Embarque. 

Le but de ce livre est de vous apprendre a ecrire des programmes GUI avec Qt 4. Le 
livre commence par "Hello Qt" et progresse rapidement vers des sujets plus avances, 
tels que la creation de widgets personnalises et le glisser-deposer. Le code source des 
exemples de programmes est telechargeable sur le site Pearson, www.pearson.fr, a la 
page dediee a cet ouvrage. L Annexe A vous explique comment installer le logiciel. 

Ce manuel se divise en trois parties. La Partie I traite de toutes les notions et pratiques 
necessaires pour programmer des applications GUI avec Qt. Si vous n'etudiez que cette 
partie, vous serez deja en mesure d'ecrire des applications GUI utiles. La Partie II aborde 
des themes importants de Qt tres en detail et la Partie III propose des sujets plus specia- 
lises et plus avances. Vous pouvez lire les chapitres des Parties II et III dans n'importe 
quel ordre, mais cela suppose que vous connaissez deja le contenu de la Partie I. 

Les lecteurs de 1' edition Qt 3 de ce livre trouveront cette nouvelle edition familiere tant 
au niveau du contenu que du style. Cette edition a ete mise a jour pour profiter des 
nouvelles fonctionnalites de Qt 4 (y compris certaines qui sont apparues avec Qt 4.1) et 
pour presenter du code qui illustre les techniques de programmation Qt4. Dans la 
plupart des cas, nous avons utilise des exemples similaires a ceux de l'edition Qt 3. Les 
nouveaux lecteurs n'en seront pas affectes, mais ceux qui ont lu la version precedente 
pourront mieux se reperer dans le style plus clair, plus propre et plus expressif de Qt 4. 
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Cette edition comporte de nouveaux chapitres analysant 1' architecture modele/vue de Qt4, le 
nouveau framework de plug-in et la programmation integree avec Qtopia, ainsi qu'une 
nouvelle annexe. Et comme dans l'edition Qt 3, nous nous sommes concentres sur l'explica- 
tion de la programmation Qt plutot que de simplement hacher ou recapituler la documentation 
en ligne de Qt. 

Nous avons ecrit ce livre en supposant que vous connaissez les langages C++, Java ou C#. Les 
exemples de code utilisent un sous-ensemble du langage C++, tout en evitant de multiples 
fonctions C++ rarement necessaires en programmation Qt. La ou il n'etait pas possible d'eviter 
une construction C++ plus avancee, nous vous avons explique son utilisation. 

Si vous connaissez deja le langage Java ou C# mais que vous avez peu d'experience en langage 
C++, nous vous recommandons de commencer par la lecture de l'Annexe B, qui vous offre une 
introduction au langage C++ dans le but de pouvoir utiliser ce manuel. Pour une introduction 
plus poussee a la programmation orientee objet en C++, nous vous conseillons les livres C+ + 
How to Program de Harvey Deitel et Paul Deitel, et C++Primer de Stanley B. Lippman, Josee 
Lajoie, et Barbara E. Moo. 

Qt a bati sa reputation de framework multiplate-forme, mais en raison de son API intuitive et 
puissante, de nombreuses organisations utilisent Qt pour un developpement sur une seule 
plate-forme. Adobe Photoshop Album est un exemple d' application Windows de masse ecrite 
en Qt. De multiples logiciels sophistiques d'entreprise, comme les outils d'animation 3D, le 
traitement de films numeriques, la conception automatisee electronique (pour concevoir des 
circuits), 1' exploration de petrole et de gaz, les services financiers et l'imagerie medicale sont 
generes avec Qt. Si vous travaillez avec un bon produit Windows ecrit en Qt, vous pouvez faci- 
lement conquerir de nouveaux marches dans les univers Mac OS X et Linux simplement grace 
a la recompilation. 

Qt est disponible sous diverses licences. Si vous souhaitez concevoir des applications commer- 
ciales, vous devez acheter une licence Qt commerciale ; si vous voulez generer des program- 
mes open source, vous avez la possibility d'utiliser l'edition open source (GPL). Qt constitue la 
base sur laquelle sont concus l'environnement KDE (K Desktop Environment) et les nombreuses 
applications open source qui y sont liees. 

En plus des centaines de classes Qt, il existe des compagnons qui etendent la portee et la puis- 
sance de Qt. Certains de ces produits, tels que QSA (Qt Script for Applications) et les compo- 
sants Qt Solutions, sont disponibles par le biais de Trolltech, alors que d'autres sont fournis par 
d'autres societes et par la communaute open source. Consultez le site http://www.troH- 
tech.com/products/3rdparty/ pour plus d' informations sur les compagnons Qt. Qt possede 
egalement une communaute bien etablie et prospere d'utilisateurs qui emploie la liste de diffusion 
qt- interest ; voir http://lists.trolltech.com/pour davantage de details. 

Si vous reperez des erreurs dans ce livre, si vous avez des suggestions pour la prochaine edition 
ou si vous voulez simplement faire un commentaire, n'hesitez pas a nous contacter. Vous 
pouvez nous joindre par mail a l'adresse suivante : qt-book@trolltech.com. Un erratum sera 
disponible sur le site http://doc.trolltech.com/qt-book-errata.html. 
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Bref historique de Qt 



Qt a ete mis a disposition du public pour la premiere fois en mai 1995. II a ete developpe 
a l'origine par Haavard Nord (le chef de la direction de Trolltech) et Eirik Chambe-Eng 
(le president de Trolltech). Haavard et Eirik se sont rencontres a l'lnstitut Norvegien de 
Technologie de Trondheim, d'ou ils sont diplomes d'un master en informatique. 

L'interet d'Haavard pour le developpement C++ d'interfaces graphiques utilisateurs 
(GUI) a debute en 1988 quand il a ete charge par une entreprise suedoise de developper 
un framework GUI en langage C++. Quelques annees plus tard, pendant l'ete 1990, 
Haavard et Eirik travaillaient ensemble sur une application C++ de base de donnees 
pour les images ultrasons. Le systeme devait pouvoir s'executer avec une GUI sous 
Unix, Macintosh et Windows. Un jour de cet ete-la, Haavard et Eirik sont sortis profiter 
du soleil, et lorsqu'ils etaient assis sur un banc dans un pare, Haavard a dit, "Nous avons 
besoin d'un systeme d'affichage oriente objet". La discussion en resultant a pose les 
bases intellectuelles d'une GUI multiplate -forme orientee objet qu'ils ne tarderaient pas 
a concevoir. 

En 1991, Haavard a commence a ecrire les classes qui deviendraient Qt, tout en collabo- 
rant avec Eirik sur la conception. Lannee suivante, Eirik a eu l'idee des "signaux et 
slots", un paradigme simple mais puissant de programmation GUI qui est desormais 
adopte par de nombreux autres kits d'outils. Haavard a repris cette idee pour en produire 
une implementation codee. En 1993, Haavard et Eirik ont developpe le premier noyau 
graphique de Qt et etaient en mesure d'implementer leurs propres widgets. A la fin de 
l'annee, Haavard a suggere de creer une entreprise dans le but de concevoir "le meilleur 
framework GUI en langage C++". 

Lannee 1994 a commence sous de mauvais auspices avec deux jeunes programmeurs 
souhaitant s'implanter sur un marche bien etabli, sans clients, avec un produit inacheve 
et sans argent. Heureusement, leurs epouses etaient leurs employees et pouvaient done 
soutenir leurs maris pendant les deux annees necessaires selon Eirik et Haavard pour 
developper le produit et enfin commencer a percevoir un salaire. 
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La lettre "Q" a ete choisie comme prefixe de classe parce que ce caractere etait joli dans l'ecri- 
ture Emacs de Haavard. Le "t" a ete ajoute pour representer "toolkit" inspire par Xt, the X 
Toolkit. La societe a ete creee le 4 mars 1994, tout d'abord sous le nom Quasar Technologies, 
puis Troll Tech et enfin Trolltech. 

En avril 1995, grace a l'un des professeurs de Haavard, l'entreprise norvegienne Metis a signe 
un contrat avec eux pour developper un logiciel base sur Qt. A cette periode, Trolltech a 
embauche Arnt Gulbrandsen, qui, pendant six ans, a imagine et implements un systeme de 
documentation ingenieux et a contribue a l'elaboration du code de Qt. 

Le 20 mai 1995, Qt 0.90 a ete telecharge sur sunsitc.unc.edu. Six jours plus tard, la publica- 
tion a ete annoncee sur tomp.os.linux. announce. Ce fut la premiere version publique de Qt. 
Qt pouvait etre utilise pour un developpement sous Windows et Unix, proposant la meme API 
sur les deux plates-formes. Qt etait disponible sous deux licences des le debut : une licence 
commerciale etait necessaire pour un developpement commercial et une edition gratuite etait 
disponible pour un developpement open source. Le contrat avec Metis a permis a Trolltech de 
rester a riot, alors que personne n'a achete de licence commerciale Qt pendant dix longs mois. 

En mars 1996, l'Agence spatiale europeenne est devenue le deuxieme client Qt, en achetant 
dix licences commerciales. Eirik et Haavard y croyaient toujours aussi fortement et ont embau- 
che un autre developpeur. Qt 0.97 a ete publie fin mai et le 24 septembre 1996, Qt 1.0 a fait son 
apparition. A la fin de la meme annee, Qt atteignait la version 1.1 : huit clients, chacun venant 
d'un pays different, ont achete 18 licences au total. Cette annee a egalement vu la naissance du 
projet KDE, mene par Matthias Ettrich. 

Qt 1.2 a ete publie en avril 1997. Matthias Ettrich a decide d'utiliser Qt pour concevoir un 
environnement KDE, ce qui a favorise 1' elevation de Qt au rang de standard de facto pour le 
developpement GUI C++ sous Linux. Qt 1.3 a ete publie en septembre 1997. 

Matthias a rejoint Trolltech en 1998 et la derniere version principale de Qt 1, 1.40, a ete concue 
en septembre de la meme annee. Qt 2.0 a ete publie en juin 1999. Qt 2 avait une nouvelle 
licence open source, QPL (Q Public License), conforme a la definition OSD (Open Source 
De?nition). En aout 1999, Qt a recu le prix LinuxWorld en tant que meilleure bibliotheque/ 
outil. A cette periode-la, Trolltech Pty Ltd (Australie) a ete fondee. 

Trolltech a publie Qtopia Core (appele ensuite Qt/Embedded) en 2000. II etait concu pour 
s'executer sur les peripheriques Linux Embarque et proposait son propre systeme de fenetrage 
en remplacement de XI 1. Qt/Xll et Qtopia Core etaient desormais proposes sous la licence 
GNU GPL (General Public License) fortement utilisee, de meme que sous des licences 
commerciales. A la fin de 1' annee 2000, Trolltech a fonde Trolltech Inc. (USA) et a publie la 
premiere version de Qtopia, une plate -forme applicative pour telephones mobiles et PDA. 
Qtopia Core a remporte le prix LinuxWorld "Best Embedded Linux Solution" en 2001 et 2002, 
et Qtopia Phone a obtenu la meme recompense en 2004. 

Qt 3.0 a ete publie en 2001. Qt est desormais disponible sous Windows, Mac OS X, Unix et 
Linux (Desktop et Embarque). Qt 3 proposait 42 nouvelles classes et son code s'elevait a 
500 000 lignes. Qt 3 a constitue une avancee incroyable par rapport a Qt 2 : un support local et 
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Unicode largement ameliore, un affichage de texte et une modification de widget totalement 
innovant et une classe d'expressions regulieres de type Perl. Qt 3 a remporte le prix "Jolt 
Productivity Award" de Software Development Times en 2002. 

En ete 2005, Qt 4.0 a ete publie. Avec pres de 500 classes et plus de 9000 fonctions, Qt 4 est 
plus riche et plus important que n'importe quelle version anterieure. II a ete divise en plusieurs 
bibliotheques, de sorte que les developpeurs ne doivent se rattacher qu'aux parties de Qt dont 
ils ont besoin. Qt 4 constitue une progression significative par rapport aux versions anterieures 
avec diverses ameliorations : un ensemble totalement nouveau de conteneurs template efficaces 
et faciles d'emploi, une fonctionnalite avancee modele/vue, un framework de dessin rapide et 
flexible en 2D et des classes de modification et d' affichage de texte Unicode, sans mentionner 
les milliers de petites ameliorations parmi toutes les classes Qt. Qt 4 est la premiere edition Qt 
disponible pour le developpement commercial et open source sur toutes les plates-formes qu'il 
supporte. 

Toujours en 2005, Trolltech a ouvert une agence a Beijing pour proposer aux clients de Chine 
et alentours un service de vente et de formation et un support technique pour Qtopia. 

Depuis la creation de Trolltech, la popularite de Qt n'a cesse de s'accroitre et continue a 
gagner du terrain aujourd'hui. Ce succes est une reflexion sur la qualite de Qt et sur la joie que 
son utilisation procure. Pendant la derniere decennie, Qt est passe du statut de produit utilise 
par quelques "connaisseurs" a un produit utilise quotidiennement par des milliers de clients et 
des dizaines de milliers de developpeurs open source dans le monde entier. 
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1 Pour debuter 

2 Creer des boites de dialogue 

3 Creer des fenetres principales 

4 Implementer la fonctionnalite d' application 

5 Creer des widgets personnalises 
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Au sommaire de ce chapitre 

Utiliser Hello Qt 

i/ Etablir des connexions 

^ Disposer des widgets 

Utiliser la documentation 
de reference 



Ce chapitre vous presente comment combiner le langage C++ de base a la fonctionnalite 
fournie par Qt dans le but de creer quelques petites applications GUI (a interface utilisa- 
teur graphique). Ce chapitre introduit egalement deux notions primordiales concernant 
Qt : les "signaux et slots" et les dispositions. Dans le Chapitre 2, vous approfondirez ces 
points, et dans le Chapitre 3, vous commencerez a concevoir une application plus realiste. 

Si vous connaissez deja les langages Java ou C#, mais que vous ne disposez que d'une 
maigre experience concernant C++, nous vous recommandons de lire tout d'abord 
1' introduction a C++ en Annexe B. 
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Hello Qt 

Commencons par un programme Qt tres simple. Nous l'etudierons d'abord ligne par ligne, 
puis nous verrons comment le compiler et l'executer. 

1 #include <QApplication> 

2 #include <QLabel> 

3 int main(int argc, char *argv[]) 

4 { 

5 QApplication app(argc, argv) ; 

6 QLabel *label = new QLabel( "Hello Qt!"); 

7 label->show( ) ; 

8 return app.exec() ; 

9 } 

Les lignes 1 et 2 contiennent les definitions des classes QApplication et QLabel. Pour 
chaque classe Qt, il y a un fichier d'en-tete qui porte le meme nom (en respectant la casse) que 
la classe qui renferme la definition de classe. 

La ligne 5 cree un objet QApplication pour gerer les ressources au niveau de 1' application. 
Le constructeur QApplication exige argc et argv parce que Qt prend personnellement en 
charge quelques arguments de ligne de commande. 

La ligne 6 cree un widget QLabel qui affiche "Hello Qt !". Dans la terminologie Qt et Unix, un 
widget est un element visuel dans une interface utilisateur. Ce terme provient de "gadget pour 
fenetres" et correspond a "controle" et "conteneur" dans la terminologie Windows. Les boutons, 
les menus et les barres de defilement sont des exemples de widgets. Les widgets peuvent 
contenir d'autres widgets ; par exemple, une fenetre d' application est habituellement un widget 
qui comporte un QMenuBar, quelques QToolBar, un QStatusBar et d'autres widgets. La 
plupart des applications utilisent un QMainWindow ou un QDialog comme fenetre d' application, 
mais Qt est si flexible que n'importe quel widget peut etre une fenetre. Dans cet exemple, le 
widget QLabel correspond a la fenetre d' application. 

La ligne 7 permet d'afficher 1' etiquette. Lors de leur creation, les widgets sont toujours masques, 
de maniere a pouvoir les personnaliser avant de les af richer et done d'eviter le phenomene du 
scintillement. 

La ligne 8 transmet le controle de 1' application a Qt. A ce stade, le programme entre dans la 
boucle d'evenement. C'est une sorte de mode d'attente oil le programme attend que l'utilisateur 
agisse, en cliquant sur la souris ou en appuyant sur une touche par exemple. Les actions de 
l'utilisateur declenchent des evenements (aussi appeles "messages") auquel le programme peut 
repondre, generalement en executant une ou plusieurs fonctions. Par exemple, quand l'utilisa- 
teur clique sur un widget, les evenements "bouton souris enfonce" et "bouton souris relache" sont 
declenches. A cet egard, les applications GUI different enormement des programmes par lots 
traditionnels, qui traitent habituellement l'entree, produisent des resultats et s'achevent sans 
intervention de quiconque. 
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Pour des questions de simplicite, nous n'appelons pas delete sur l'objet QLabel a la fin de la 
fonction main ( ). Cette petite fuite de memoire est insignifiante dans un programme de cette 
taille, puisque la memoire est recuperee de toute facon par le systeme d' exploitation des qu'il 
se termine. 

Hello sur Linux * - 



Vous pouvez desormais tester le programme sur votre ordinateur. Vous devrez d'abord installer 
Qt 4.1.1 (ou une version ulterieure de Qt 4), un processus explique en Annexe A. A partir de 
maintenant, nous supposons que vous avez correctement installe une copie de Qt 4 et que le 
repertoire bin de Qt se trouve dans votre variable d'environnement PATH. (Sous Windows, 
c'est effectue automatiquement par le programme d' installation de Qt.) Vous aurez egalement 
besoin du code source du programme dans un fichier appele hello . cpp situe dans un reper- 
toire nomme hello. Vous pouvez saisir le code de ce programme vous-meme ou le copier 
depuis le CD fourni avec ce livre, a partir du fichier /examples/chapOl/hello/hello.cpp. 

Depuis une invite de commande, placez-vous dans le repertoire hello, puis saisissez 
qmake -project 

pour creer un fichier de projet independant de la plate-forme (hello .pro), puis tapez 
qmake hello. pro 

pour creer un fichier Makefile du fichier de projet specifique a la plate-forme. 

Tapez make pour generer le programme. 1 Executez-le en saisissant hello sous Windows, 
./hello sous Unix et open hello. app sous Mac OS X. Pour terminer le programme, 
cliquez sur le bouton de fermeture dans la barre de titre de la fenetre. 

Si vous utilisez Windows et que vous avez installe Qt Open Source Edition et le compilateur 
MinGW, vous aurez acces a un raccourci vers la fenetre d' invite DOS ou toutes les variables 
d'environnement sont correctement installees pour Qt. Si vous lancez cette fenetre, vous 
pouvez y compiler des applications Qt grace a qmake et make decrits precedemment. Les 
executables produits sont places dans les dossiers debug ou release de l'application, par 
exemple C:\qt-book\hello\release\hello.exe. 




Hello Qt! 



1. Si vous obtenez une erreur du compilateur sur <QApplication>, cela signifie certainement que vous 
utilisez une version plus ancienne de Qt. Assurez-vous d' utiliser Qt 4. 1 . 1 ou une version ulterieure de Qt 4. 
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Si vous vous servez de Microsoft Visual C++, vous devrez executer nmake au lieu de make. 
Vous pouvez aussi creer un fichier de projet Visual Studio depuis hello . pro en tapant 

qmake -tp vc hello. pro 

puis concevoir le programme dans Visual Studio. Si vous travaillez avec Xcode sous Mac OS 
X, vous avez la possibility de generer un projet Xcode a l'aide de la commande 

qmake -spec macx-xcode 
Figure 1.2 

Une etiquette avec une 
mise en forme HTML 
basique 

Avant de continuer avec l'exemple 

QLabel *label = new QLabel( "Hello Qt!"); 

par 

QLabel *label = new QLabel( "<h2><i>Hello</i> " 

"<font color=red>Qt!</font></h2>") ; 

et generez a nouveau l'application. Comme l'illustre cet exemple, il est facile d'egayer l'inter- 
face utilisateur d'une application Qt en utilisant une mise en forme simple de style HTML 
(voir Figure 1.2). 

Etablir des connexions 

Le deuxieme exemple vous montre comment repondre aux actions de l'utilisateur. L'applica- 
tion propose un bouton sur lequel l'utilisateur peut cliquer pour quitter. Le code source ressem- 
ble beaucoup a Hello, sauf que nous utilisons un QPushButton en lieu et place de QLabel 
comme widget principal et que nous connectons Taction d'un utilisateur (cliquer sur un 
bouton) a du code. 

Le code source de cette application se trouve sur le site web de Pearson, www.pearson.fr, a la 
page dediee a cet ouvrage, sous /examples/chapOl/quit/quit.cpp. 
Voici le contenu du fichier : 

1 #include <QApplication> 

2 #include <QPushButton> 

3 int main(int argc, char *argv[]) 

4 { 

5 QApplication app(argc, argv); 

6 QPushButton "button = new QPushButton( "Quit" ) ; 

7 QObject: :connect(button, SIGNAL(clicked( ) ) , 

8 &app, SLOT(quit() ) ) ; 



Hello Qt!]| 

suivant, amusons-nous un peu : remplacez la ligne 
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9 button->show( ) ; 

10 return app.execf) ; 

11 } 

Les widgets de Qt emettent des signaux pour indiquer qu'une action utilisateur ou un change- 
ment d'etat a eu lieu. 1 Par exemple, QPushButton emet un signal clicked ( ) quand l'utilisa- 
teur clique sur le bouton. Un signal peut etre connecte a une fonction (appele un slot dans ce 
cas), de sorte qu'au moment ou le signal est emis, le slot soit execute automatiquement. Dans 
notre exemple, nous relions le signal clicked ( ) du bouton au slot quit ( ) de l'objet QAppli- 
cation. Les macros SIGNAL ( ) et SLOT ( ) font partie de la syntaxe ; elles sont expliquees plus 
en detail dans le prochain chapitre. 

Figure 1.3 

L 'application Quit 




Nous allons desormais generer 1' application. Nous supposons que vous avez cree un repertoire 
appele quit contenant quit . cpp (voir Figure 1.3). Executez qmake dans le repertoire quit 
pour generer le fichier de projet, puis executez-le a nouveau pour generer un richier Makefile, 
comme suit : 

qmake -project 
qmake quit. pro 

A present, generez 1' application et executez-la. Si vous cliquez sur Quit ou que vous appuyez 
sur la barre d'espace (ce qui enfonce le bouton), 1' application se termine. 



Disposer des widgets 

Dans cette section, nous allons creer une petite application qui illustre comment utiliser les 
dispositions, des outils pour gerer la disposition des widgets dans une fenetre et comment utiliser 
des signaux et des slots pour synchroniser deux widgets. L' application demande l'age de l'utili- 
sateur, qu'il peut regler par le biais d'un pointeur toupie ou d'un curseur (voir Figure 1.4). 



Figure 1.4 

U application Age 



-»■ Enter Your Age -Ox 




J 



L' application contient trois widgets : QSpinBox, QSlider et QWidget. QWidget correspond 
a la fenetre principale de 1' application. QSpinBox et QSlider sont affiches dans QWidget ; 



1. Les signaux Qt ne sont pas lies aux signaux Unix. Dans ce livre, nous ne nous interessons qu'aux 
signaux Qt. 
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ce sont des enfants de QWidget. Nous pouvons aussi dire que QWidget est le parent de 
QSpinBox et QSlider. QWidget n'a pas de parent puisque c'est une fenetre de niveau le plus 
haut. Les constructeurs de QWidget et toutes ses sous-classes recoivent un parametre QWidget 
* qui specific le widget parent. 

Voici le code source : 

1 #include <QApplication> 

2 #include <QHBoxLayout> 

3 #include <QSlider> 

4 #include <QSpinBox> 

5 int main(int argc, char *argv[]) 

6 { 



7 


Ur\|jp± lOd L XUI 1 a\J jJ [ a 1 y L , a I y V / , 


8 


QWidget *window = new QWidget; 


9 


window->setWindowTitle(" Enter your age"); 


10 


QSpinBox *spinBox = new QSpinBox; 


11 


QSlider *slider = new QSliderfQt: :Horizontal) ; 


12 


spinBox->setRange(0, 130); 


13 


slider->setRange(0, 130); 


14 


QObject: :connect(spinBox, SIGNAL(valueChanged(int) ) , 


15 


slider, SLOTfsetValue(int) ) ) ; 


16 


QObject: :connect(slider, SIGNAL(valueChanged(int) ) , 


17 


spinBox, SLOTfsetValue(int) ) ) ; 


18 


spinBox->setValue(35) ; 


19 


QHBoxLayout *layout = new QHBoxLayout; 


20 


layout->addWidget(spinBox) ; 


21 


layout->addWidget(slider) ; 


22 


window->setLayout(layout) ; 


23 


window->show( ) ; 


24 


return app.exec() ; 


25 } 





Les lignes 8 et 9 configurent QWidget qui fera office de fenetre principale de 1' application. 
Nous appelons setWindowTitle ( ) pour definir le texte affiche dans la barre de titre de la 
fenetre. 

Les lignes 10 et 11 creent QSpinBox et QSlider, et les lignes 12 et 13 determinent leurs 
plages valides. Nous pouvons affirmer que l'utilisateur est age au maximum de 130 ans. Nous 
pourrions transmettre window aux constructeurs de QSpinBox et QSlider, en specifiant que le 
parent de ces widgets doit etre window, mais ce n'est pas necessaire ici, parce que le systeme 
de positionnement le deduira lui-meme et definira automatiquement le parent du pointeur 
toupie (spin box) et du curseur, comme nous allons le voir. 
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Les deux appels QObj ect : : connect ( ) presentes aux lignes 14 a 17 garantissent que le poin- 
teur toupie et le curseur sont synchronises, de sorte qu'ils affichent toujours la meme valeur. 
Des que la valeur d'un widget change, son signal valueChanged (int) est emis et le slot 
setValue ( int ) de l'autre widget est appele avec la nouvelle valeur. 

La ligne 18 derinit la valeur du pointeur toupie en 35. QSpinBox emet done le signal value- 
Changed (int) avec un argument int de 35. Cet argument est transmis au slot setVa- 
lue ( int ) de QSlider, qui derinit la valeur du curseur en 35. Le curseur emet ensuite le signal 
valueChanged ( int ) puisque sa propre valeur a change, declenchant le slot setValue ( int ) 
du pointeur toupie. Cependant, a ce stade, setValue ( int ) n'emet aucun signal, parce que la 
valeur du pointeur toupie est deja de 35. Vous evitez ainsi une recursivite inrinie. La Figure 1.5 
recapitule la situation. 



Figure 1.5 

Changer la valeur d'un 
widget entraine la modifi- 
cation des deux widgets 



1. 



o: 



[Value (G 



351: 



valueChanged(35) 

I 



351 



setValue(35) 
I 



valueChanged(35) 



setValue(35) 
4. 351 



Dans les lignes 19 a 22, nous positionnons le pointeur toupie et le curseur a l'aide d'un 
gestionnaire de disposition (layout manager). Ce gestionnaire est un objet qui derinit la taille 
et la position des widgets qui se trouvent sous sa responsabilite. Qt propose trois principaux 
gestionnaires de disposition : 

• QHBoxLayout dispose les widgets horizontalement de gauche a droite (de droite a gauche 
dans certaines cultures). 

• QVBoxLayout dispose les widgets verticalement de haut en bas. 

• QGridLayout dispose les widgets dans une grille. 

Lorsque vous appelez QWidget : : set Layout ( ) a la ligne 22, le gestionnaire de disposition 
est installe dans la fenetre. En arriere-plan, QSpinBox et QSlider sont "reparentes" pour deve- 
nir des enfants du widget sur lequel la disposition s' applique, et e'est pour cette raison que 
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nous n'avons pas besoin de specifier un parent explicite quand nous construisons un widget qui 
sera insere dans une disposition. 

Figure 1.6 

Les widgets 
de V application Age 

QWidget 



Meme si nous n'avons pas defini explicitement la position ou la taille d'un widget, QSpinBox 
et QSlider apparaissent convenablement cote a cote. C'est parce que QHBoxLayout assigne 
automatiquement des positions et des tailles raisonnables aux widgets dont il est responsable 
en fonction de leurs besoins. Grace aux gestionnaires de disposition, vous evitez la corvee de 
coder les positions a l'ecran dans vos applications et vous etes sfir que les fenetres seront redi- 
mensionnees correctement. 

L'approche de Qt pour ce qui concerne la conception des interfaces utilisateurs est facile a 
comprendre et s'avere tres flexible. Habituellement, les programmeurs Qt instancient les 
widgets necessaires puis definissent leurs proprietes de maniere adequate. Les programmeurs 
ajoutent les widgets aux dispositions, qui se chargent automatiquement de leur taille et de leur 
position. Le comportement de 1' interface utilisateur est gere en connectant les widgets ensembles 
grace aux signaux et aux slots de Qt. 

Utiliser la documentation de reference 

La documentation de reference de Qt est un outil indispensable pour tout developpeur Qt, 
puisqu'elle contient toutes les classes et fonctions de cet environnement. Ce livre utilise de 
nombreuses classes et fonctions Qt, mais il ne les aborde pas toutes et ne fournit pas de plus 
amples details sur celles qui sont evoquees. Pour profiter pleinement de Qt, vous devez vous 
familiariser avec la documentation de reference le plus rapidement possible. 

Cette documentation est disponible en format HTML dans le repertoire doc/html de Qt et peut 
etre affichee dans n'importe quel navigateur Web. Vous pouvez egalement utiliser V Assistant 
Qt, le navigateur assistant de Qt, qui propose des fonctionnalites puissantes de recherche et 
d' index qui sont plus faciles et plus rapides a utiliser qu'un navigateur Web. Pour lancer 
V Assistant Qt, cliquez sur Qt by Trolltech v4.x.y/Assistant dans le menu Demarrer sous 
Windows, saisissez assistant dans la ligne de commande sous Unix ou double-cliquez sur 
Assistant dans le Finder de Mac OS X (voir Figure 1.7). 

Les liens dans la section "API Reference" sur la page d'accueil fournissent differents moyens 
de localiser les classes de Qt. La page "All Classes" repertorie chaque classe dans 1' API de Qt. 
La page "Main Classes" regroupe uniquement les classes Qt les plus frequemment utilisees. 
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En guise d'entrainement, vous rechercherez les classes et les fonctions dont nous avons parlees 
dans ce chapitre. 
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Figure 1.7 

La documentation de Qt dans 1' Assistant sous Mac OS X 



Notez que les fonctions heritees sont detaillees dans la classe de base ; par exemple, QPush- 
Button ne possede pas de fonction show(), mais il en herite une de son ancetre QWidget. 
La Figure 1.8 vous montre comment les classes que nous avons etudieesj usque la sont liees les 
unes aux autres. 



Figure 1.8 

Arbre d' heritage des 
classes Qt etudiees 
jusqu 'a present 



QObject 
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QCoreApplication 



QApplication 



QWidget 



QLayout 
QBoxLayout 



QAbstractButton QAbstractButton QAbstractSlider QFrame QHBoxLayout 
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QPushButton QSpinBox QSIider QLabel 
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La documentation de reference pour la version actuelle de Qt et pour certaines versions ante- 
rieures est disponible en ligne a l'adresse suivante, http://doc.trolltech.com/. Ce site propose 
egalement des articles selectionnes dans Qt Quarterly, la lettre d' information des programmeurs 
Qt envoyee a tous les detenteurs de licences. 



Styles des widgets 

Les captures presentees jusque la ont ete effectuees sous Linux, mais les applications Qt se 
fondent parfaitement dans chaque plate-forme prise en charge. Qt y parvient en emulant 
I'aspect et I'apparence de la plate-forme, au lieu d'adopter un ensemble de widgets de boTte a 
outils ou de plate-forme particulier. 



Figure 1.9 

Styles disponibles 
partout 
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CDE 



Motif 



Dans Qt/X1 1 et Qtopia Core, le style par defaut est Plastique. II utilise des degrades et I'anticre- 
nelage pour proposer un aspect et une apparence modernes. Les utilisateurs de I'application 
Qt peuvent passer outre ce style par defaut grace a I'option de ligne de commande -style. 
Par exemple, pour lancer I'application Age avec le style Motif sur X1 1, tapez simplement 

. /age -style motif 



sur la ligne de commande. 



Figure 1.10 

Styles specifiques a la 
plate-forme 
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Windows XP 



Mac 



Contrairement aux autres styles, les styles Windows XP et Mac ne sont disponibles que sur leurs 
plate-formes natives, puisqu'ils se basent sur les generateurs de theme de ces plate-formes. 
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Ce chapitre vous a presente les concepts essentiels des connexions signal - slot et des disposi- 
tions. II a egalement commence a devoiler l'approche totalement orientee objet et coherente de 
Qt concernant la construction et l'utilisation des widgets. Si vous parcourez la documentation 
de Qt, vous decouvrirez que l'approche s'avere homogene. Vous comprendrez done beaucoup 
plus facilement comment utiliser de nouveaux widgets et vous verrez aussi que les noms choisis 
minutieusement pour les fonctions, les parametres, les enumerations, etc. rendent la program- 
mation dans Qt etonnamment plaisante et aisee. 

Les chapitres suivants de la Partie I se basent sur les notions fondamentales etudiees ici et vous 
expliquent comment creer des applications GUI completes avec des menus, des barres d'outils, 
des fenetres de document, une barre d'etat et des boites de dialogue, en plus des fonctionnalites 
sous-jacentes permettant de lire, traiter et ecrire des fichiers. 



2 



Creer des boites de dialogue 




Au sommaire de ce chapitre 

Derivation de QDialog 

^ Description detaillee des signaux et slots 

i/ Conception rapide d'une boite de dialogue 

^ Boites de dialogue multiformes 

✓ Boites de dialogue dynamiques 

1/ Classes de widgets et de boites de dialogue 
integrees 



Dans ce chapitre, vous allez apprendre a creer des boites de dialogue a l'aide de Qt. 
Celles-ci presentent diverses options et possibilites aux utilisateurs et leur permettent de 
definir les valeurs des options et de faire des choix. On les appelle des boites de dialogue, 
puisqu'elles donnent la possibility aux utilisateurs et aux applications de "discuter". 

La majorite des applications GUI consiste en une fenetre principale equipee d'une barre 
de menus et d'outils, a laquelle on ajoute des douzaines de boites de dialogue. II est 
egalement possible de creer des applications "boite de dialogue" qui repondent directe- 
ment aux choix de l'utilisateur en accomplissant les actions appropriees (par exemple, 
une application de calculatrice). 
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Nous allons creer notre premiere boite de dialogue en ecrivant completement le code pour vous en 
expliquer le fonctionnement. Puis nous verrons comment concevoir des boites de dialogue grace 
au Qt Designer, un outil de conception de Qt. Avec le Qt Designer, vous codez beaucoup plus 
rapidement et il est plus facile de tester les differentes conceptions et de les modifier par la suite. 



Derivation de QDialog 



Notre premier exemple est une boite de dialogue Find ecrite totalement en langage C++ (voir 
Figure 2.1). Nous l'implementerons comme une classe a part entiere. Ainsi, elle deviendra un 
composant independant et autonome, comportant ses propres signaux et slots. 



Figure 2.1 

La boite de dialogue Find 



Find what: Waldo 

x Match case 

□ Search backward 



Find 



Close 



Le code source est reparti entre deux fichiers : f inddialog . h et f inddialog . cpp. Nous 
commencerons par f inddialog . h. 

1 #ifndef FINDDIALOGJH 

2 #define FINDDIALOGJH 

3 #include <QDialog> 

4 class QCheckBox; 

5 class QLabel; 

6 class QLineEdit; 

7 class QPushButton; 

Les lignes 1 et 2 (et 27) protegent le fichier d'en-tete contre les inclusions multiples. 

La ligne 3 contient la definition de QDialog, la classe de base pour les boites de dialogue dans 
Qt. QDialog herite de QWidget. 

Les lignes 4 a 7 sont des declarations prealables des classes Qt que nous utiliserons pour 
implementer la boite de dialogue. Une declaration prealable informe le compilateur C++ 
qu'une classe existe, sans donner tous les details d'une definition de classe (generalement 
situee dans un fichier d'en-tete). Nous en parlerons davantage dans un instant. 

Nous definissons ensuite FindDialog comme une sous-classe de QDialog : 

8 class FindDialog : public QDialog 

9 { 

10 Q OBJECT 
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11 public: 

12 FindDialog(QWidget *parent = 0); 

La macro Q_OBJECT au debut de la definition de classe est necessaire pour toutes les classes qui 
definissent des signaux ou des slots. 

Le constructeur de FindDialog est typique des classes Qt de widgets. Le parametre parent 
specirie le widget parent. Par defaut, c'est un pointeur nul, ce qui signirie que la boite de dialogue 
n'a pas de parent. 

13 signals: 

14 void findNextfconst QString &str, Qt : :CaseSensitivity cs); 

15 void f indPrevious(const QString &str, Qt: :CaseSensitivity cs); 

La section des signaux declare deux signaux que la boite de dialogue emet quand l'utilisateur 
clique sur le bouton Find. Si 1' option Search backward est activee, la boite de dialogue emet 
f indPrevious ( ) ; sinon elle emet f indNext ( ). 

Le mot-cle signals est en fait une macro. Le preprocesseur C++ la convertit en langage C++ 
standard avant que le compilateur ne la voie. Qt : : CaseSensitivity est un type enumeration 
qui peut prendre les valeurs Qt : : CaseSensitive et Qt : : Caselnsensitive. 

16 private slots: 

17 void findClicked() ; 

18 void enableFindButton(const QString &text); 

19 private: 

20 QLabel *label; 

21 QLineEdit *lineEdit; 

22 QCheckBox *caseCheckBox; 

23 QCheckBox *backwardCheckBox; 

24 QPushButton *f indButton; 

25 QPushButton *closeButton; 

26 }; 

27 #endif 

Dans la section privee de la classe, nous declarons deux slots. Pour implementer les slots, vous 
devez avoir acces a la plupart des widgets enfants de la boite de dialogue, nous conservons 
done egalement des pointeurs vers eux. Le mot-cle slots, comme signals, est une macro qui 
se developpe pour produire du code que le compilateur C++ peut digerer. 

S'agissant des variables privees, nous avons utilise les declarations prealables de leurs classes. 
C'etait possible puisque ce sont toutes des pointeurs et que nous n'y accedons pas dans le 
fichier d'en-tete, le compilateur n'a done pas besoin des definitions de classe completes. Nous 
aurions pu inclure les fichiers d'en-tete importants (<QCheckBox>, <QLabel>, etc.), mais la 
compilation se revele plus rapide si vous utilisez les declarations prealables des que possible. 
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Nous allons desormais nous pencher sur finddialog.cpp qui contient 1' implementation de la 
classe FindDialog. 

1 #include <QtGui> 

2 #include "finddialog.h" 

Nous incluons d'abord <QtGui>, un fichier d'en-tete qui contient la definition des classes GUI 
de Qt. Qt est constitue de plusieurs modules, chacun d'eux se trouvant dans sa propre biblio- 
theque. Les modules les plus importants sont QtCore, QtGui, QtNetwork, QtOpenGL, QtSql, 
QtSvg et QtXml. Le fichier d'en-tete <QtGui> renferme la definition de toutes les classes qui 
font partie des mo dules QtCore et QtGui. En incluant cet en-tete, vous evitez la tache fasti- 
dieuse d'inclure chaque classe separement. 

Dans f iledialog . h, au lieu d'inclure <QDialog> et d'utiliser des declarations prealables 
pour QCheckBox, QLabel, QLineEdit et QPushButton, nous aurions simplement pu specifier 
<QtGui>. Toutefois, il est generalement malvenu d'inclure un fichier d'en-tete si grand depuis 
un autre fichier d'en-tete, notamment dans des applications plus importantes. 

3 FindDialog: : FindDialog (QWidget *parent) 

4 : QDialog (parent) 

5 { 

6 label = new QLabel(tr( "Find &what:")); 

7 lineEdit = new QLineEdit; 

8 label->setBuddy(lineEdit) ; 

9 caseCheckBox = new QCheckBox(tr( "Match Scase")); 

10 backwardCheckBox = new QCheckBox(tr( "Search Sbackward" ) ) ; 

11 findButton = new QPushButton(tr( "&Find" ) ) ; 

12 findButton->setDefault(true) ; 

13 findButton->setEnabled(false) ; 

14 closeButton = new QPushButton(tr( "Close" )) ; 

A la ligne 4, nous transmettons le parametre parent au constructeur de la classe de base. Puis 
nous creons les widgets enfants. Les appels de la fonction tr( ) autour des litteraux chaine les 
marquent dans l'optique d'une traduction en d'autres langues. La fonction est declaree dans 
QOb j ect et chaque sous-classe qui contient la macro Q_0BJECT. II est recommande de prendre 
l'habitude d'encadrer les chaines visibles par l'utilisateur avec tr ( ) , meme si vous n'avez pas 
l'intention de faire traduire vos applications en d'autres langues dans l'immediat. La traduction 
des applications Qt est abordee au Chapitre 17. 

Dans les litteraux chaine, nous utilisons le caractere & pour indiquer des raccourcis clavier. Par 
exemple, la ligne 11 cree un bouton Find que l'utilisateur peut activer en appuyant sur Alt+F 
sur les plates-formes qui prennent en charge les raccourcis clavier. Le caractere & peut egale- 
ment etre employe pour controler le focus, c'est-a-dire 1' element actif : a la ligne 6, nous 
creons une etiquette avec un raccourci clavier (Alt+W), et a la ligne 8, nous definissons 
l'editeur de lignes comme widget compagnon de l'etiquette. Ce compagnon (buddy) est un widget 
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qui recoit le focus quand vous appuyez sur le raccourci clavier de 1' etiquette. Done, quand 
l'utilisateur appuie sur Alt+W (le raccourci de l'etiquette), l'editeur de lignes recoit le controle. 

A la ligne 12, nous faisons du bouton Find le bouton par defaut de la boite de dialogue en 
appelant setDef ault (true). Le bouton par defaut est le bouton qui est presse quand l'utili- 
sateur appuie sur Entree. A la ligne 13, nous desactivons le bouton Find. Quand un widget est 
desactive, il apparait generalement grise et ne repondra pas en cas d'interaction de l'utilisateur. 

15 connect (lineEdit, SIGNAL(textChanged (const QString &)), 

16 this, SLOT(enableFindButton(const QString &))); 

17 connect(findButton, SIGNAL (clicked ( ) ) , 

18 this, SLOT(findClicked())); 

19 connect(closeButton, SIGNAL(clicked( ) ) , 

20 this, SLOT(close())); 

Le slot prive enableFindButton (const QString &) est appele des que le texte change 
dans l'editeur de lignes. Le slot prive f indClicked ( ) est invoque lorsque l'utilisateur clique 
sur le bouton Find. La boite de dialogue se ferme si l'utilisateur clique sur Close. Le slot 
close ( ) est herite de QWidget et son comportement par defaut consiste a masquer le widget 
(sans le supprimer). Nous allons etudier le code des slots enableFindButton ( ) et find- 
Clicked () ulterieurement. 

Etant donne que QObject est l'un des ancetres de FindDialog, nous pouvons omettre le 
prefixe QObj ect : : avantles appels de connect (). 
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QHBoxLayout *topLef tLayout = new QHBoxLayout 


22 


topLeftLayout->addWidget( label) ; 


23 


topLeftLayout->addWidget (lineEdit) ; 


24 


QVBoxLayout *lef tLayout = new QVBoxLayout; 


25 


leftLayout->addLayout (topLef tLayout) ; 


26 


leftLayout->addWidget (caseCheckBox) ; 


27 


leftLayout->addWidget (backwardCheckBox) ; 


28 


QVBoxLayout *rightLayout = new QVBoxLayout; 


29 


rightLayout->addWidget (f indButton) ; 


30 


rightLayout->addWidget (closeButton) ; 


31 


rightLayout->addStretch( ) ; 


32 


QHBoxLayout *mainLayout = new QHBoxLayout; 


33 


mainLayout->addLayout(lef tLayout) ; 


34 


mainLayout->addLayout (rightLayout) ; 


35 


setLayout(mainLayout) ; 



Nous disposons ensuite les widgets enfants a l'aide des gestionnaires de disposition. Les dispo- 
sitions peuvent contenir des widgets et d'autres dispositions. En imbriquant QHBoxLayout, 
QVBoxLayout et QGridLayout dans diverses combinaisons, il est possible de concevoir des 
boites de dialogue tres sophistiquees. 
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Figure 2.2 

Les dispositions de la 
boite de dialogue Find 



i Titre de la fenetre 



leftLayout - 
topLeftLayout - 



QLabel 



QLineEdit 



QCheckBox 



QCheckBox 



QPushButton 



QPushButton 



' L - I 



-rightLayout 
-rightLayout 



i_ Element 

i d'espacement 



Pour la boite de dialogue Find, nous employons deux QHBoxLayout et deux QVBoxLayout, 
comme illustre en Figure 2.2. La disposition externe correspond a la disposition principale ; 
elle est installee sur FindDialog a la ligne 35 et est responsable de toute la zone de la boite de 
dialogue. Les trois autres dispositions sont des sous-dispositions. Le petit "ressort" en bas a 
droite de la Figure 2.2 est un element d'espacement (ou "etirement"). II comble l'espace vide sous 
les boutons Find et Close, ces boutons sont done stirs de se trouver en haut de leur disposition. 

Les gestionnaires de disposition presentent une subtilite : ce ne sont pas des widgets. lis heri- 
tent de QLayout, qui herite a son tour de QOb j ect. Dans la figure, les widgets sont represented 
par des cadres aux traits pleins et les dispositions sont illustrees par des cadres en pointilles 
pour mettre en avant la difference qui existe entre eux. Dans une application en execution, les 
dispositions sont invisibles. 

Quand les sous-dispositions sont ajoutees a la disposition parent (lignes 25, 33 et 34), les sous- 
dispositions sont automatiquement reparentees. Puis, lorsque la disposition principale est 
installee dans la boite de dialogue (ligne 35), elle devient un enfant de cette derniere et tous les 
widgets dans les dispositions sont reparentes pour devenir des enfants de la boite de dialogue. 
La hierarchie parent-enfant ainsi obtenue est presentee en Figure 2.3. 

36 setWindowTitle(tr( "Find") ) ; 

37 setFixedHeight (sizeHint ( ) .height ( ) ) ; 

38 } 



Figure 2.3 

Les relations parent- 
enfant de la boite de 
dialogue Find 



FindDialog 

— QLabel (label) 

— QLineEdit (lineEdit) 

— QCheckBox (caseCheckBox) 

— QCheckBox (backwardCheckBox) 

— QPushButton (andButton) 

— QPushButton (closeButton) 

— QHBoxLayout (mainLayout) 
— QVBoxLayout (leftLayout) 

I — QHBoxLayout (topLeftLayout) 
- QVBoxLayout (rightLayout) 



Enfin, nous definissons le titre a afficher dans la barre de titre de la boite de dialogue et nous 
configurons la fenetre pour qu'elle presente une hauteur fixe, etant donne qu'elle ne contient 
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aucun widget qui peut occuper de l'espace supplementaire verticalement. La fonction QWid- 
get : : sizeHint ( ) retourne la taille "ideale" d'un widget. 

Ceci termine l'analyse du constructeur de FindDialog. Vu que nous avons cree les widgets et 
les dispositions de la boite de dialogue avec new, il semblerait logique d'ecrire un destructeur 
qui appelle delete sur chaque widget et disposition que nous avons crees. Toutefois, ce n'est 
pas necessaire, puisque Qt supprime automatiquement les objets enfants quand le parent est 
detruit, et les dispositions et widgets enfants sont tous des descendants de FindDialog. 

Nous allons a present analyser les slots de la boite de dialogue : 

39 void FindDialog: :findClicked() 

40 { 



41 QString text = lineEdit->text() ; 

42 Qt : :CaseSensitivity cs = 

43 caseCheckBox->isChecked( ) ? Qt: :CaseSensitive 

44 : Qt : :CaseInsensitive; 

45 if (backwardCheckBox->isChecked( ) ) { 

46 emit findPreviousftext, cs); 

47 } else { 

48 emit findNextftext, cs); 

49 } 



50 } 

51 void FindDialog: :enableFindButton(const QString &text) 

52 { 

53 f indButton->setEnabled( !text . isEmpty( ) ) ; 

54 } 

Le slot f indClicked ( ) est appele lorsque l'utilisateur clique sur le bouton Find. II emet le 
signal f indPrevious ( ) ou f indNext( ), en fonction de l'option Search backward. Le mot- 
cle emit est specifique a Qt ; comme les autres extensions Qt, il est converti en langage C++ 
standard par le preprocesseur C++. 

Le slot enableFindButton ( ) est invoque des que l'utilisateur modifie le texte dans l'editeur 
de lignes. II active le bouton s'il y a du texte dans cet editeur, sinon il le desactive. 

Ces deux slots completent la boite de dialogue. Nous avons desormais la possibilite de creer un 
fichier main . cpp pour tester notre widget FindDialog : 



1 #include <QApplication> 

2 #include "f inddialog.h" 

3 int main(int argc, char *argv[]) 

4 { 

5 QApplication appfargc, argv) ; 

6 FindDialog *dialog = new FindDialog; 

7 dialog->show( ) ; 

8 return app.execf ) ; 

9 } 



Pour compiler le programme, executez qmake comme d'habitude. Vu que la definition de la 
classe FindDialog comporte la macro Q_0BJECT, le fichier Makefile genere par qmake 
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contiendra des regies particulieres pour executer moc, le compilateur de meta-objets de Qt. 
(Le systeme de meta-objets de Qt est aborde dans la prochaine section.) 

Pour que moc fonctionne correctement, vous devez placer la definition de classe dans un fichier 
d'en-tete, separe du fichier d'implementation. Le code genere par moc inclut ce fichier d'en- 
tete et ajoute une certaine "magie" C++. 

moc doit etre execute sur les classes qui se servent de la macro Q_0BJECT. Ce n'est pas un 
probleme parce que qmake ajoute automatiquement les regies necessaires dans le fichier Make- 
file. Toutefois, si vous oubliez de generer a nouveau votre fichier Makefile a l'aide de qmake et 
que moc n'est pas execute, l'editeur de liens indiquera que certaines fonctions sont declarees 
mais pas implementees. Les messages peuvent etre plutot obscurs. GCC produit des avertissements 
comme celui-ci : 

finddialog.o: In function 1 FindDialog: :tr(char const*, char const*) 1 : 
/usr/lib/qt/src/corelib/global/qglobal.h:1430: undefined reference to 
' FindDialog : : staticMetaObj ect ' 

La sortie de Visual C++ commence ainsi : 

finddialog.obj : error LNK2001 : unresolved external symbol 

"public:-virtual int thiscall MyClass: :qt_metacall(enum QMetaObject 

: : Call, int, void * *) " 

Si vous vous trouvez dans ce cas, executez a nouveau qmake pour mettre a jour le fichier 
Makefile, puis generez a nouveau 1' application. 

Executez maintenant le programme. Si des raccourcis clavier apparaissent sur votre plate- 
forme, verifiez que les raccourcis Alt+W, Alt+C, Alt+B et Alt+F declenchent le bon comportement. 
Appuyez sur la touche de tabulation pour parcourir les widgets en utilisant le clavier. L'ordre 
de tabulation par defaut est l'ordre dans lequel les widgets ont ete crees. Vous pouvez le modifier 
grace a QWidget : : setTabOrder ( ). 

Proposer un ordre de tabulation et des raccourcis clavier coherents permet aux utilisateurs qui 
ne veulent pas (ou ne peuvent pas) utiliser une souris de profiter pleinement de l'application. 
Les dactylos apprecieront egalement de pouvoir tout controler depuis le clavier. 

Dans le Chapitre 3, nous utiliserons la boite de dialogue Find dans une application reelle, et 
nous connecterons les signaux findPrevious() etfindNext() a certains slots. 

Description detaillee des signaux et slots 

Le mecanisme des signaux et des slots est une notion fondamentale en programmation Qt. 
II permet au programmeur de l'application de relier des objets sans que ces objets ne sachent 
quoi que ce soit les uns sur les autres. Nous avons deja connecte certains signaux et slots 
ensemble, declare nos propres signaux et slots, implements nos slots et emis nos signaux. 
Etudions desormais ce mecanisme plus en detail. 
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Les slots sont presque identiques aux fonctions membres ordinaires de C++. lis peuvent etre 
virtuels, surcharges, publics, proteges ou prives, etre invoques directement comme toute autre 
fonction membre C++, et leurs parametres peuvent etre de n'importe quel type. La difference 
est qu'un slot peut aussi etre connecte a un signal, auquel cas il est automatiquement appele a 
chaque fois que le signal est emis. 

Voici la syntaxe de 1' instruction connect ( ) : 

connect(sender, SIGNAL(signal) , receiver, SLOT(slot)); 

ou sender et receiver sont des pointeurs vers QObj ect et ou signal et slot sont des signa- 
tures de fonction sans les noms de parametre. Les macros SIGNAL ( ) et SL0T( ) convertissent 
leur argument en chaine. 

Dans les exemples etudies jusque la, nous avons toujours connecte les signaux aux divers slots. 
II existe d'autres possibilites a envisager. 

• Un signal peut etre connecte a plusieurs slots : 

connect(slider, SIGNAL(valueChanged(int) ) , 

spinBox, SLOT(setValue(int) ) ) ; 
connect(slider, SIGNAL(valueChangedfint) ) , 

this, SLOT(updateStatusBarIndicator(int) ) ) ; 

Quand le signal est emis, les slots sont appeles les uns apres les autres, dans un ordre non 
specifie. 

• Plusieurs signaux peuvent etre connectes au meme slot : 

connect(lcd, SIGNAL(overf low( ) ) , 

this, SLOT(handleMathError())); 
connect (calculator, SIGNAL (divisionByZero ( ) ) , 

this, SLOT(handleMathError())); 

Quand Tun des signaux est emis, le slot est appele. 

• Un signal peut etre connecte a un autre signal : 

connectflineEdit, SIGNAL(textChanged(const QString &)), 
this, SIGNAL(updateRecord(const QString &))); 

Quand le premier signal est emis, le second est egalement emis. En dehors de cette caracte- 
ristique, les connexions signal-signal sont en tout point identiques aux connexions 
signal-slot. 

• Les connexions peuvent etre supprimees : 

disconnect (led, SIGNAL ( overflow ( ) ) , 

this, SLOT(handleMathError())); 

Vous n'en aurez que tres rarement besoin, parce que Qt supprime automatiquement toutes 
les connexions concernant un objet quand celui-ci est supprime. 
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Pour bien connecter un signal a un slot (ou a un autre signal), ils doivent avoir les memes types 
de parametre dans le meme ordre : 

connectfftp, SIGNAL ( rawCommandReply ( int , const QString &)), 
this, SLOT(processReply(int, const QString &))); 

Exceptionnellement, si un signal comporte plus de parametres que le slot auquel il est 
connecte, les parametres supplementaires sont simplement ignores : 

connectfftp, SIGNAL (rawCommandReply (int, const QString &)), 
this, SLOT(checkErrorCode(int) ) ) ; 

Si les types de parametre sont incompatibles, ou si le signal ou le slot n'existe pas, Qt emettra 
un avertissement au moment de l'execution si 1' application est generee en mode debogage. De 
meme, Qt enverra un avertissement si les noms de parametre se trouvent dans les signatures du 
signal ou du slot. 

Jusqu'a present, nous n'avons utilise que des signaux et des slots avec des widgets. Cependant, le 
mecanisme en soi est implemente dans QOb j ect et ne se limite pas a la programmation d'interfaces 
graphiques utilisateurs. II peut etre employe par n'importe quelle sous-classe de QOb j ect : 

class Employee : public QObject 
{ 

Q_0BJECT 
public: 

Employee () { mySalary = 0; } 

int salary () const { return mySalary; } 

public slots: 

void setSalary(int newSalary); 

signals: 

void salaryChanged(int newSalary); 

private: 

int mySalary; 

}; 

void Employee: :setSalary(int newSalary) 
{ 

if (newSalary != mySalary) { 
mySalary = newSalary; 
emit salaryChanged (mySalary) ; 

} 

} 

Vous remarquerez la maniere dont le slot setSalary ( ) est implemente. Nous n'emettons 
le signal salaryChanged ( ) que si newSalary ! = mySalary. Vous etes done sur que les 
connexions cycliques ne debouchent pas sur des boucles infinies. 
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Systeme de meta-objets de Qt 

L'une des ameliorations majeures de Qt a ete I'introduction dans le langage C++ d'un meca- 
nisme permettant de creer des composants logiciels independants qui peuvent etre relies les 
uns aux autres sans qu'ils ne sachent absolument rien sur les autres composants auxquels ils 
sont connectes. 

Ce mecanisme est appele systeme de meta-objets et propose deux services essentiels : les 
signaux-slots et I'introspection. La fonction d'introspection est necessaire pour implementer 
des signaux et des slots et permet aux programmeurs d'applications d'obtenir des "meta- 
informations" sur les sous-classes de QObject a I'execution, y compris la liste des signaux et des 
slots pris en charge par I'objet et le nom de sa classe. Le mecanisme supporte egalement 
des proprietes (pour le Qt Designer) et des traductions de texte (pour I'internationalisation), 
et il pose les fondements de QSA (Qt Script for Applications). 

Le langage C++ standard ne propose pas de prise en charge des meta-informations dynami- 
ques necessaires pour le systeme de meta-objets de Qt. Qt resout ce probleme en fournissant 
un outil, moc, qui analyse les definitions de classe Q OBJECT et rend les informations disponibles 
par le biais de fonctions C++. Etant donne que moc implemente toute sa fonctionnalite en utili- 
sant un langage C++ pur, le systeme de meta-objets de Qt fonctionne avec n'importe quel 
compilateur C++. 

Ce mecanisme fonctionne de la maniere suivante : 

• La macro Q OBJECT declare certaines fonctions d'introspection qui doivent etre implementees 
dans chaque sous-classe de QObject : metaOb]'ect( ), tr(), qt_metacall( ) et quelques 
autres. 

• L'outil moc de Qt genere des implementations pour les fonctions declarees par Q OBJECT 
et pour tous les signaux. 

• Les fonctions membres de QObject, telles que connectf) et disconnect ), utilisent les 
fonctions d'introspection pour effectuer leurs taches. 

Tout est gere automatiquement par qmake, moc et QObject, vous ne vous en souciez done que 
tres rarement. Neanmoins, par curiosite, vous pouvez parcourir la documentation de la classe 
QMetaObject et analyser les fichiers sources C++ generes par moc pour decouvrir comment 
fonctionne I'implementation. 



Conception rapide d'une boite de dialogue 

Qt est concu pour etre agreable et intuitif a ecrire, et il n'est pas inhabituel que des program- 
meurs developpent des applications Qt completes en saisissant la totalite du code source C++. 
De nombreux programmeurs preferent cependant utiliser une approche visuelle pour concevoir 
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les formulaires. lis la trouvent en effet plus naturelle et plus rapide, et ils veulent etre en 
mesure de tester et de modifier leurs conceptions plus rapidement et facilement qu'avec des 
formulaires codes manuellement. 

Le Qt Designer developpe les options a disposition des programmeurs en proposant une fonc- 
tionnalite visuelle de conception. Le Qt Designer peut etre employe pour developper tous les 
formulaires d'une application ou juste quelques-uns. Les formulaires crees a l'aide du Qt Desi- 
gner etant uniquement constitues de code C++, le Qt Designer peut etre utilise avec une chaine 
d'outils traditionnelle et n' impose aucune exigence particuliere au compilateur. 

Dans cette section, nous utiliserons le Qt Designer afin de creer la boite de dialogue Go-to-Cell 
presentee en Figure 2.4. Quelle que soit la methode de conception choisie, la creation d'une 
boite de dialogue implique toujours les memes etapes cles : 

• creer et initialiser les widgets enfants ; 

• placer les widgets enfants dans des dispositions ; 

• definir l'ordre de tabulation ; 

• etablir les connexions signal-slot ; 

• implementer les slots personnalises de la boite de dialogue. 



Figure 2.4 

La boite de dialogue 
Go-to-Cell 



Cell Location: A12 



OK 



Cancel 



Pour lancer le Qt Designer, cliquez sur Qt by Trolltech v4.x.y > Designer dans le menu Demar- 
rer sous Windows, saisissez designer dans la ligne de commande sous Unix ou double- 
cliquez sur Designer dans le Finder de Mac OS X. Quand le Qt Designer demarre, une liste de 
modeles s'affiche. Cliquez sur le modele "Widget", puis sur OK. (Le modele "Dialog with 
Buttons Bottom" peut etre tentant, mais pour cet exemple nous creerons les boutons OK et 
Cancel manuellement pour vous expliquer le processus.) Vous devriez a present vous trouver 
dans une fenetre appelee "Untitled". 

Par defaut, l'interface utilisateur du Qt Designer consiste en plusieurs fenetres de haut niveau. 
Si vous preferez une interface de style MDI, avec une fenetre de haut niveau et plusieurs sous- 
fenetres, cliquez sur Edit > User Interface Mode > Docked Window (voir Figure 2.5). 

La premiere etape consiste a creer les widgets enfants et a les placer sur le formulaire. Creez 
une etiquette, un editeur de lignes, un element d'espacement horizontal et deux boutons de 
commande. Pour chaque element, faites glisser son nom ou son icone depuis la boite des 
widgets du Qt Designer vers son emplacement sur le formulaire. Lelement d'espacement, qui 
est invisible dans le formulaire final, est affiche dans le Qt Designer sous forme d'un ressort bleu. 
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Faites glisser le bas du formulaire vers le haut pour le retrecir. Vous devriez voir un formulaire 
similaire a celui de la Figure 2.6. Ne perdez pas trop de temps a positionner les elements sur le 
formulaire ; les gestionnaires de disposition de Qt les disposeront precisement par la suite. 



Figure 2.6 

Le formulaire 

avec quelques widgets 



TextLabel f 



PushButton 



PushButton 



Configurez les proprietes de chaque widget a l'aide de l'editeur de proprietes du Qt Designer : 

1. Cliquez sur l'etiquette de texte. Assurez-vous que la propriete objectName est label et 
definissez la propriete text en &Cell Location : . 

2. Cliquez sur l'editeur de lignes. Verifiez que la propriete ob j ectName est lineEdit. 

3. Cliquez sur le premier bouton. Configurez la propriete objectName en okButton, la 
propriete enabled en false, la propriete text en OK et la propriete default en true. 

4. Cliquez sur le second bouton. Definissez la propriete ob j ectName en cancelButton et la 
propriete text en Cancel. 

5. Cliquez sur l'arriere-plan du formulaire pour selectionner ce dernier. Definissez object- 
Name en GoToCellDialog et windowTitle en Go to Cell. 

Tous les widgets sont correctement presentes, sauf l'etiquette de texte, qui affiche &Cell Location. 
Cliquez sur Edit > Edit Buddies pour passer dans un mode special qui vous permet de configurer 
les compagnons. Cliquez ensuite sur l'etiquette et faites glisser la fleche rouge vers l'editeur de 
lignes. L'etiquette devrait presenter le texte "Cell Location" et l'editeur de lignes devrait etre 
son widget compagnon. Cliquez sur Edit > Edit widgets pour quitter le mode des compagnons. 
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Figure 2.7 

Le formulaire dont les 
proprietes sont definies 



Untitled' 



■ Cell Location: ■ f 



Cancel 



La prochaine etape consiste a disposer les widgets sur le formulaire : 

1. Cliquez sur 1' etiquette Cell Location et maintenez la touche Maj enfoncee quand vous cliquez 
sur l'editeur de lignes, de maniere a ce qu'ils soient selectionnes tous les deux. Cliquez sur 
Form > Lay Out Horizontally. 

2. Cliquez sur l'element d'espacement, maintenez la touche Maj enfoncee et appuyez sur les 
boutons OK et Cancel du formulaire. Cliquez sur Form > Lay Out Horizontally. 

3. Cliquez sur l'arriere-plan du formulaire pour annuler toute selection d' element, puis cliquez 
sur Form > Lay Out Vertically. 

4. Cliquez sur Form > Ajust Size pour redimensionner le formulaire. 

Les lignes rouges qui apparaissent sur le formulaire montrent les dispositions qui ont ete 
creees. Elles ne s'affichent pas lorsque le formulaire est execute. 



Figure 2.8 

Le formulaire avec 
les dispositions 
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Cliquez a present sur Edit > Edit Tab Order. Un nombre apparaitra dans un rectangle bleu a 
cote de chaque widget qui peut devenir actif (voir Figure 2.9). Cliquez sur chaque widget dans 
l'ordre dans lequel vous voulez qu'ils recoivent le focus, puis cliquez sur Edit > Edit widgets 
pour quitter le mode d'edition de l'ordre de tabulation. 

Figure 2.9 

Definir l'ordre 
de tabulation 
du formulaire 




Pour avoir un apercu de la boite de dialogue, selectionnez 1' option Form > Preview du menu. 
Verifiez l'ordre de tabulation en appuyant plusieurs fois sur la touche Tab. Fermez la boite de 
dialogue en appuyant sur le bouton de fermeture dans la barre de titre. 
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Enregistrez la boite de dialogue sous gotocelldialog . ui dans un repertoire appele gotocell, 
et creez un fichier main . cpp dans le meme repertoire grace a un editeur de texte ordinaire : 

#include <QApplication> 
#include <QDialog> 

#include "ui_gotocelldialog.h" 

int mainfint argc, char *argv[]) 
{ 

QApplication appfargc, argv); 

Ui: :GoToCellDialog ui; 
QDialog *dialog = new QDialog; 
ui.setupUi(dialog) ; 
dialog->show( ) ; 

return app.exec() ; 

} 

Executez maintenant qmake pour creer un fichier .pro et un Makefile (qmake - pro] ect; qmake 
goto-cell. pro). L'outil qmake est suffisamment intelligent pour detecter le fichier de l'inter- 
face utilisateur gotocelldialog . ui et pour generer les regies appropriees du fichier Make- 
file. II va done appeler uic, le compilateur Qt de l'interface utilisateur. L'outil uic convertit 
gotocelldialog . ui en langage C++ et integre les resultats dans ui_gotocelldialog . h. 

Le fichier ui_gotocelldialog . h genere contient la definition de la classe Ui : :GoToCell- 
Dialog qui est un equivalent C++ du fichier gotocelldialog . ui. La classe declare des 
variables membres qui stockent les widgets enfants et les dispositions du formulaire, et une 
fonction setupUi ( ) qui initialise le formulaire. Voici la syntaxe de la classe generee : 

class Ui: :GoToCellDialog 
{ 

public: 

QLabel *label; 
QLineEdit *lineEdit; 
QSpacerltem *spacerltem; 
QPushButton *okButton; 
QPushButton *cancelButton; 



void setupUi(QWidget *widget) { 
} 

}; 

Cette classe n'herite pas de n'importe quelle classe Qt. Quand vous utilisez le formulaire dans 
main . cpp, vous creez un QDialog et vous le transmettez a setupUi( ). 
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Si vous executez le programme maintenant, la boite de dialogue fonctionnera, mais pas exactement 
comme vous le souhaitiez : 

• Le bouton OK est toujours desactive. 

• Le bouton Cancel ne fait rien. 

• L'editeur de lignes accepte n'importe quel texte, au lieu d'accepter uniquement des empla- 
cements de cellule valides. 

Pour faire fonctionner correctement la boite de dialogue, vous devrez ecrire du code. La 
meilleure approche consiste a creer une nouvelle classe qui herite a la fois de QDialog et de 
Ui : : GoToCellDialog et qui implemente la fonctionnalite manquante (ce qui prouve que tout 
probleme logiciel peut etre resolu simplement en ajoutant une autre couche d' indirection). 
Notre convention de denomination consiste a attribuer a cette nouvelle classe le meme nom 
que la classe generee par uic, mais sans le prefixe Ui : : . 

A l'aide d'un editeur de texte, creez un fichier nomme gotocelldialog . h qui contient le 
code suivant : 

#ifndef GOTOCELLDIALOGJH 
#define G0T0CELLDIAL0G_H 

#include <QDialog> 

#include "ui_gotocelldialog.h" 

class GoToCellDialog : public QDialog, public Ui: :GoToCellDialog 
{ 

Q_0BJECT 
public: 

GoToCellDialog (QWidget *parent = 0); 

private slots: 

void on_lineEdit_textChanged( ) ; 

}; 

#endif 

L implementation fait partie de gotocelldialog . cpp : 

#include <QtGui> 

#include "gotocelldialog. h" 

GoToCellDialog: : GoToCellDialog (QWidget *parent) 
: QDialog(parent) 

{ 

setupUi(this) ; 



QRegExp regExp( " [A-Za-z] [1-9] [0-9] {0,2}" ) ; 
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lineEdit->setValidator(new QRegExpValidator(regExp, this)); 

connect (okButton, SIGNAL(clicked( ) ) , this, SLOT(accept ( ) ) ) ; 
connect(cancelButton, SIGNAL(clicked( ) ) , this, SLOT(reject( ) ) ) ; 

} 

void GoToCellDialog : : on_lineEdit_textChanged ( ) 
{ 

okButton->setEnabled(lineEdit->hasAcceptableInput ( ) ) ; 

} 

Dans le constructeur, nous appelons setupUi( ) pour initialiser le formulaire. Grace a l'heri- 
tage multiple, nous pouvons acceder directement aux membres de Ui: : GoToCellDialog. 
Apres avoir cree l'interface utilisateur, setupUi() connectera egalement automatiquement 
tout slot qui respecte la convention de denomination on_Nomobjet_NomSignal( ) au signal 
nomSignal( ) correspondant de objectName. Dans notre exemple, cela signifie que setupUi( ) 
etablira la connexion signal- slot suivante : 

connect(lineEdit, SIGNAL(textChanged(const QString &)), 
this, SLOT(on_lineEdit_textChanged() ) ) ; 

Toujours dans le constructeur, nous definissons un validateur qui restreint la plage des valeurs 
en entree. Qt propose trois classes de validateurs :QIntValidator, QDoubleValidator et 
QRegExpValidator. Nous utilisons ici QRegExpValidator avec l'expression reguliere 
"[A-Za-z][l-9][0-9]{0,2}", qui signifie : autoriser une lettre majuscule ou minuscule, suivie 
d'un chiffre entre 1 et 9, puis de zero, un ou deux chiffres entre 0 et 9. (En guise d' introduction 
aux expressions regulieres, consultez la documentation de la classe QRegExp.) 

Si vous transmettez ceci au constructeur de QRegExpValidator, vous en faites un enfant de 
l'objet GoToCellDialog. Ainsi, vous n'avez pas besoin de prevoir la suppression de QRegExp- 
Validator ;il sera supprime automatiquement en me me temps que son parent. 

Le mecanisme parent-enfant de Qt est implements dans QObj ect. Quand vous creez un objet 
(un widget, un validateur, ou autre) avec un parent, le parent ajoute l'objet a sa liste d'enfants. 
Quand le parent est supprime, il parcourt sa liste d'enfants et les supprime. Les enfants eux-memes 
effacent ensuite tous leurs enfants, et ainsi de suite jusqu'a ce qu'il n'en reste plus aucun. 

Ce mecanisme parent-enfant simplifie nettement la gestion de la memoire, reduisant les risques 
de fuites de memoire. Les seuls objets que vous devrez supprimer explicitement sont les objets 
que vous creez avec new et qui n'ont pas de parent. Et si vous supprimez un objet enfant avant 
son parent, Qt supprimera automatiquement cet objet de la liste des enfants du parent. 

S'agissant des widgets, le parent a une signification supplemental : les widgets enfants sont 
affiches dans la zone du parent. Quand vous supprimez le widget parent, 1' enfant est efface de 
la memoire mais egalement de l'ecran. 

A la fin du constructeur, nous connectons le bouton OK au slot accept ( ) de QDialog et le 
bouton Cancel au slot rej ect ( ) . Les deux slots ferment la boite de dialogue, mais accept ( ) 
definit la valeur de resultat de la boite de dialogue en QDialog : : Accepted (qui est egal a 1), 
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et reject () configure la valeur en QDialog: : Rejected (egal a 0). Quand nous utilisons 
cette boite de dialogue, nous avons la possibilite d'utiliser la valeur de resultat pour voir si 
l'utilisateur a clique sur OK et agir de facon appropriee. 

Le slot on_lineEdit_textChanged ( ) active ou desactive le bouton OK, selon que l'editeur 
de lignes contient un emplacement de cellule valide ou non. QLineEdit : : hasAcceptable- 
Input ( ) emploie le validateur que nous avons defini dans le constructeur. 

Ceci termine la boite de dialogue. Vous pouvez desormais reecrire main . cpp pour l'utiliser : 

#include <QApplication> 

#include "gotocelldialog.h" 

int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
GoToCellDialog *dialog = new GoToCellDialog; 
dialog->show( ) ; 
return app.execf) ; 

} 

Regenerez l'application (qmake -project ; qmake gotocell . pro) et executez-la a 
nouveau. Tapez "A12" dans l'editeur de lignes et vous verrez que le bouton OK s'active. 
Essayez de saisir du texte aleatoire pour verifier que le validateur effectue bien sa tache. 
Cliquez sur Cancel pour fermer la boite de dialogue. 

L'un des avantages du Qt Designer, c'est que les programmeurs sont libres de modifier la 
conception de leurs formulaires sans etre obliges de changer leur code source. Quand vous 
developpez un formulaire simplement en redigeant du code C++, les modifications apportees a 
la conception peuvent vous faire perdre enormement de temps. Grace au Qt Designer, vous 
gagnez en efficacite parce que uic regenere simplement le code source pour tout formulaire 
modifie. L interface utilisateur de la boite de dialogue est enregistree dans un fichier . ui (un 
format de fichier base sur le langage XML), alors que la fonctionnalite personnalisee est imple- 
mented en sous-classant la classe generee par uic. 

Boites de dialogue multiformes 

Nous avons vu comment creer des boites de dialogue qui affichent toujours les memes widgets 
lors de leur utilisation. Dans certains cas, il est souhaitable de proposer des boites de dialogue 
dont la forme peut varier. Les deux types les plus courants de boites de dialogue multiformes 
sont les boites de dialogue extensibles et les boites de dialogue multipages. Ces deux types de 
boites de dialogue peuvent etre implementes dans Qt, simplement dans du code ou par le biais 
du Qt Designer. 
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Les boites de dialogue extensibles ont habituellement une apparence simple, mais elles propo- 
sent un bouton de basculement qui permet a l'utilisateur d'alterner entre les apparences simple 
et developpee de la boite de dialogue. Ces boites de dialogue sont generalement utilisees dans 
des applications qui tentent de repondre a la fois aux besoins des utilisateurs occasionnels et a 
ceux des utilisateurs experimentes, masquant les options avancees a moins que l'utilisateur ne 
demande explicitement a les voir. Dans cette section, nous utiliserons le Qt Designer arin de 
creer la boite de dialogue extensible presentee en Figure 2.10. 

C'est une boite de dialogue Sort dans un tableur, oil l'utilisateur a la possibility de selectionner 
une ou plusieurs colonnes a trier. L' apparence simple de cette boite de dialogue permet a 
l'utilisateur de saisir une seule cle de tri, et son apparence developpee propose deux cles de tri 
supplementaires. Grace au bouton More, l'utilisateur bascule entre les apparences simple et 
developpee. 



Figure 2.10 

La boite de dialogue Sort 
dans ses deux versions, 
simple et developpee 
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Nous creerons le widget avec son apparence developpee dans le Qt Designer, et nous masque- 
rons les cles secondaires et tertiaires a l'execution. Le widget semble complexe, mais il est 
assez simple a realiser dans le Qt Designer. L'astuce est de se charger d'abord de la cle 
primaire, puis de la dupliquer deux fois pour obtenir les cles secondaires et tertiaires : 

1. Cliquez sur File > New Form et selectionnez le modele "Dialog with Buttons Right". 

2. Creez le bouton More et faites-le glisser dans la disposition verticale, sous l'element 
d'espacement vertical. Definissez la propriete text du bouton More en &More et sa 
propriete checkable en true. Configurez la propriete default du bouton OK en true. 

3. Creez une zone de groupe, deux etiquettes, deux zones de liste deroulante et un element 
d'espacement horizontal, puis placez-les sur le formulaire. 

4. Faites glisser le coin inferieur droit de la zone de groupe pour l'agrandir. Puis deplacez les 
autres widgets dans la zone de groupe pour les positionner a peu pres comme dans la 
Figure 2.11 (a). 
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5. Faites glisser le bord droit de la seconde zone de liste deroulante, de sorte qu'elle soit environ 
deux fois plus grande que la premiere zone de liste. 

6. Derinissez la propriete title de la zone de groupe en &Primary Key, la propriete text de 
la premiere etiquette en Column : et celle de la deuxieme etiquette en Order : . 

7. Cliquez du bouton droit sur la premiere zone de liste deroulante et selectionnez Edit Items 
dans le menu contextuel pour ouvrir l'editeur de zone de liste deroulante du Qt Designer. 
Creez un element avec le texte "None". 

8. Cliquez du bouton droit sur la seconde zone de liste deroulante et selectionnez Edit Items. 
Creez les elements "Ascending" et "Descending". 

9. Cliquez sur la zone de groupe, puis sur Form > Lay Out in a Grid. Cliquez a nouveau sur la 
zone de groupe et sur Form > Adjust Size. Vous aboutirez a la disposition affichee dans 
la Figure 2.11 (b). 



Figure 2.11 
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Si une disposition ne s'avere pas tres bonne ou si vous avez fait une erreur, vous pouvez toujours 
cliquer sur Edit > Undo ou Form > Break Layout, puis repositionner les widgets et reessayer. 
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Nous allons maintenant ajouter les zones de groupe Secondary Key et Tertiary Key : 

1. Prenez garde a ce que la fenetre soit assez grande pour accueillir les composants supple- 
mentaires. 

2. Maintenez la touche Ctrl enfoncee (Alt sur Mac) et cliquez sur la zone de groupe Primary 
Key pour en creer une copie (et de son contenu) au-dessus de l'original. Faites glisser la 
copie sous la zone de groupe originale en gardant toujours la touche Ctrl (ou Alt) enfoncee. 
Repetez ce processus pour creer une troisieme zone de groupe, en la faisant glisser sous la 
deuxieme zone. 

3. Transformez leurs proprietes title en &Secondary Key et &Tertiary Key. 

4. Creez un element d'espacement vertical et placez-le entre la zone de la cle primaire et celle 
de la cle secondaire. 

5. Disposez les widgets comme illustre en Figure 2.12 (a). 

6. Cliquez sur le formulaire pour annuler la selection de tout widget, puis sur Form > Lay Out 
in a Grid. Le formulaire devrait desormais correspondre a celui de la Figure 2. 12 (b). 

7. Definissez la propriete sizeHint des deux elements d'espacement verticaux en [20, 0]. 

La disposition de type grille qui en resulte comporte deux colonnes et quatre lignes, ce qui fait 
un total de huit cellules. La zone de groupe Primary Key, l'element d'espacement vertical le 
plus a gauche, les zones de groupe Secondary Key et Tertiary Key occupent chacun une seule 
cellule. La disposition verticale qui contient les boutons OK, Cancel et More occupe deux 
cellules. II reste done deux cellules vides en has a droite de la boite de dialogue. Si ce n'est pas 
le cas, annulez la disposition, repositionnez les widgets et essayez a nouveau. 

Renommez le formulaire "SortDialog" et changez le titre de la fenetre en "Sort". Definissez les 
noms des widgets enfants comme dans la Figure 2.13. 



Figure 2.13 
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Cliquez sur Edit > Edit Tab Order. Cliquez sur chaque zone de liste deroulante de haut en bas, 
puis cliquez sur les boutons OK, Cancel et More situes a droite. Cliquez sur Edit > Edit 
Widgets pour quitter le mode edition de l'ordre de tabulation. 

Maintenant que le formulaire a ete concu, nous sommes prets a le rendre fonctionnel en confi- 
gurant certaines connexions signal-slot. Le Qt Designer vous permet d'etablir des connexions 
entre les widgets qui font partie du me me formulaire. Nous devons etablir deux connexions. 

Cliquez sur Edit > Edit Signals/Slots pour passer en mode de connexion dans le Qt Designer. 
Les connexions sont representees par des fleches bleues entre les widgets du formulaire. Vu 
que nous avons choisi le modele "Dialog with Buttons Right", les boutons OK et Cancel sont 
deja connectes aux slots accept ( ) et re j ect ( ) de QDialog. Les connexions sont egalement 
repertoriees dans l'editeur de signal/slot du Qt Designer. 

Pour etablir une connexion entre deux widgets, cliquez sur le widget "expediteur" et faites glis- 
ser la fleche rouge vers le widget "destinataire".Une boite de dialogue s'ouvre ou vous pouvez 
choisir le signal et le slot a connecter. 



Figure 2.14 
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La premiere connexion est a etablir entre moreButton et secondaryGroupBox. Faites glisser 
la fleche rouge entre ces deux widgets, puis choisissez toggled (bool) comme signal et 
setVisible(bool) comme slot. Par defaut, le Qt Designer ne repertorie pas setVisi- 
ble(bool) dans sa liste de slots, mais il apparaitra si vous activez l'option Show all signals 
and slots. 

Vous devez ensuite creer une connexion entre le signal toggled (bool) de moreButton etle 
slot setVisible(bool) de tertiaryGroupBox. Lorsque les connexions sont effectuees, 
cliquez sur Edit > Edit Widgets pour quitter le mode de connexion. 
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Figure 2.15 
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Enregistrez la boite de dialogue sous sortdialog . ui dans un repertoire appele sort. Pour 
ajouter du code au formulaire, vous emploierez la meme technique d' heritage multiple que 
celle utilisee pour la boite de dialogue Go-to-Cell de la section precedente. 

Creez tout d'abord un fichier sortdialog . h qui comporte les elements suivants : 

#ifndef SORTDIALOGJH 
#define S0RTDIAL0G_H 

#include <QDialog> 

#include "ui_sortdialog.h" 

class SortDialog : public QDialog, public Ui: :SortDialog 
{ 

Q_0BJECT 
public: 

SortDialog (QWidget *parent = 0); 

void setColumnRange(QChar first, QChar last); 

}; 

#endif 

Puis creez sortdialog . cpp : 

1 #include <QtGui> 

2 #include "sortdialog. h" 

3 SortDialog: : SortDialog (QWidget *parent) 

4 : QDialog(parent) 

5 { 

6 setupUi(this) ; 

7 secondaryGroupBox->hide( ) ; 

8 tertiaryGroupBox->hide() ; 
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9 layout ()->setSizeConstraint(QLayout: :SetFixedSize) ; 

10 setColumnRange( 1 A 1 , 'Z'); 

11 } 

12 void SortDialog: :setColumnRange(QChar first, QChar last) 

13 { 

14 primaryColumnCombo->clear( ) ; 

15 secondaryColumnCombo->clear( ) ; 

16 tertiaryColumnCombo->clear( ) ; 

17 secondaryColumnCombo->addItem(tr( "None" ) ) ; 

18 tertiaryColumnCombo->addItem(tr( "None" ) ) ; 

19 primaryColumnCombo->setMinimumSize( 

20 secondaryColumnCombo->sizeHint ( ) ) ; 

21 QChar ch = first; 

22 while (ch <= last) { 

23 primaryColumnCombo->addItem(QString(ch) ) ; 

24 secondaryColumnCombo->addItem(QString(ch) ) ; 

25 tertiaryColumnCombo->addItem(QString(ch) ) ; 

26 ch = ch.unicode() + 1 ; 

27 } 

28 } 



Le constructeur masque les zones secondaire et tertiaire de la boite de dialogue. II definit aussi 
la propriete sizeConstraint de la disposition du formulaire en QLayout : : SetFixedSize, 
l'utilisateur ne pourra done pas la redimensionner. La disposition se charge ensuite de redi- 
mensionner automatiquement la boite de dialogue quand des widgets enfants sont afhehes ou 
masques, vous etre done sur que la boite de dialogue sera toujours presentee dans sa taille 
optimale. 

Le slot setColumnRange ( ) initialise le contenu des zones de liste deroulante en fonction des 
colonnes selectionnees dans le tableur. Nous inserons un element "None" dans ces zones de 
liste pour les cles secondaire et tertiaire (facultatives). 

Les lignes 19 et 20 presentent un comportement subtil de la disposition. La fonction (Mid- 
get: : sizeHint ( ) retourne la taille "ideale" d'un widget, ce que le systeme de disposition 
essaie de respecter. Ceci explique pourquoi les differents types de widgets, ou des widgets 
similaires avec un contenu different, peuvent se voir attribuer des tailles differentes par le 
systeme de disposition. Concernant les zones de liste deroulante, cela signifie que les zones 
secondaire et tertiaire qui contiennent "None" seront plus grandes que la zone primaire qui ne 
contient que des entrees a une lettre. Pour eviter cette incoherence, nous definissons la taille 
minimale de la zone de liste deroulante primaire en taille ideale de la zone secondaire. 

Voici une fonction de test main ( ) qui configure la plage de maniere a inclure les colonnes C a 
F, puis affiche la boite de dialogue : 

#include <QApplication> 

#include "sortdialog.h" 
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int mainfint argc, char *argv[]) 
{ 

QApplication appfargc, argv); 
SortDialog *dialog = new SortDialog; 
dialog->setColumnRange( 'C , ' F ' ) ; 
dialog->show( ) ; 
return app.exec() ; 

} 

Ceci termine la boite de dialogue extensible. Vous pouvez constater que ce type de boite de 
dialogue n'est pas plus complique a concevoir qu'une boite de dialogue ordinaire : tout ce dont 
vous avez besoin, c'est un bouton de basculement, quelques connexions signal-slot supple- 
mentaires et une disposition non redimensionnable. Dans des applications de production, il est 
assez frequent que le bouton qui controle 1' extension affiche le texte Advanced »> quand 
seule la boite de dialogue de base est visible et Advanced «< quand elle est developpee. C'est 
facile a concevoir dans Qt en appelant setText ( ) sur QPushButton des qu'on clique dessus. 

L' autre type courant de boite de dialogue multiforme, les boites de dialogue multipages, est 
encore plus facile a concevoir dans Qt, soit en creant le code, soit par le biais du Qt Designer. 
De telles boites de dialogue peuvent etre generees de diverses manieres. 

Q Un QTabWidget peut etre exploite independamment. II propose une barre d'onglets en 
haut qui controle un QStackedWidget integre. 

• Un QListWidget et un QStackedWidget peuvent etre employes ensemble, avec l'element en 
cours de QListWidget qui determine quelle page est affichee par QStackedWidget, en 
connectant le signal QListWidget :: currentRowChanged ( ) au slot QStacked- 
Widget: :setCurrentIndex(). 

• Un QTreeWidget peut etre utilise avec un QStackedWidget de la meme facon qu'avec un 
QListWidget. 

• La classe QStackedWidget est abordee au Chapitre 6. 



Boites de dialogue dynamiques 

Les boites de dialogue dynamiques sont creees depuis les fichiers .ui du Qt Designer au 
moment de l'execution. Au lieu de convertir le fichier .ui en code C++ grace a uic, vous 
pouvez charger le fichier a l'execution a l'aide de la classe QUiLoader : 

QUiLoader uiLoader; 

QFile file( "sortdialog.ui" ) ; 

QWidget *sortDialog = uiLoader. load (&f ile) ; 

if (SortDialog) { 



} 
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Vous pouvez acceder aux widgets enfants du formulaire en utilisant QOb j ect : : f indChild<T> ( ) : 

QComboBox *primaryColumnCombo = 

sortDialog->f indChild<QComboBox *>( "primaryColumnCombo" ) ; 
if (primaryColumnCombo) { 

} 

La fonction f indChild<T> ( ) est une fonction membre modele qui retourne l'objet enfant qui 
correspond au nom et au type donne. Vu les limites du compilateur, elle n'est pas disponible 
pour MSVC 6. Si vous devez utiliser le compilateur MSVC 6, appelez plutot la fonction 
globale qFindChild<T> ( ) qui fonctionne exactement de la meme facon. 

La classe QUiLoader se situe dans une bibliotheque a part. Pour employer QUiLoader depuis 
une application Qt, vous devez ajouter cette ligne de code au fichier . pro de l'application : 

CONFIG += uitools 

Les boites de dialogue dynamiques vous permettent de modifier la disposition d'un formulaire 
sans recompiler l'application. Elles peuvent aussi servir a creer des applications client leger, oil 
l'executable integre principalement un formulaire frontal et ou tous les autres formulaires sont 
crees comme necessaire. 



Classes de widgets et de boites de dialogue 
integrees 

Qt propose un ensemble complet de widgets integres et de boites de dialogue courantes adap- 
tes a la plupart des situations. Dans cette section, nous allons presenter une capture de la 
plupart d'entre eux. Quelques widgets specialises ne sont etudies qu'ulterieurement : les 
widgets de fenetre principale comme QMenuBar, QToolBar et QStatusBar sont abordes dans 
le Chapitre 3, et les widgets lies a la disposition, tels que QSplitter et QScrollArea, sont 
analyses dans le Chapitre 6. La majorite des widgets integres et des boites de dialogue est 
presentee dans les exemples de ce livre. Dans les captures suivantes, les widgets sont affiches 
avec le style Plastique. 



Figure 2.16 
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Qt propose quatre types de "boutons" : QPushButton, QToolButton, QCheckBox et QRadio- 
Button. QPushButton et QToolButton sont le plus souvent ajoutes pour initier une action 
quand on clique dessus, mais ils peuvent aussi se comporter comme des boutons de basculement 
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(clic pour enfoncer, clic pour restaurer). QCheckBox peut servir pour les options independantes 
on/off, alors que les QRadioButton s'excluent mutuellement. 

Figure 2.17 
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Les widgets conteneurs de Qt sont des widgets qui contiennent d'autres widgets. QFrame peut 
aussi etre employe seul pour tracer simplement des lignes et il est herite par la plupart des 
autres classes de widgets, dont QToolBox et QLabel. 



Figure 2.18 
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QTabWidget et QToolBox sont des widgets multipages. Chaque page est un widget enfant, et 
les pages sont numerotees en commencant a 0. 

Figure 2.19 
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Les affichages d' elements sont optimises pour gerer de grandes quantites de donnees et font 
souvent appel a des barres de defilement. Le mecanisme de la barre de defilement est imple- 
ments dans QAbstractScrollArea, une classe de base pour les affichages d'elements et 
d'autres types de widgets a defilement. 

Qt fournit quelques widgets simplement destines a la presentation des informations. QLabel 
est le plus important d'entre eux et peut etre employe pour afficher un texte enrichi (grace a 
une syntaxe simple de style HTML) et des images. 

QTextBrowser est une sous-classe de QTextEdit en lecture seule qui prend en charge la 
syntaxe HTML de base, y compris les listes, les tables, les images et les liens hypertexte. 
L Assistant de Qt se sert de QTextBrowser pour presenter la documentation a l'utilisateur. 



Figure 2.20 
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Qt propose plusieurs widgets pour les entrees de donnees. QLineEdit peut controler son 
entree par le biais d'un masque de saisie ou d'un validateur. QTextEdit est une sous-classe de 
QAbstractScrollArea capable de modifier de grandes quantites de texte. 

Qt met a votre disposition un ensemble standard de boites de dialogue courantes pratiques pour 
demander a l'utilisateur de choisir une couleur, une police ou un fichier ou d'imprimer un 
document. 

Sous Windows et Mac OS X, Qt exploite les boites de dialogue natives plutot que ses propres 
boites de dialogue si possible. 

Une boite de message polyvalente et une boite de dialogue d'erreur qui conserve les messages 
affiches apparaissent. La progression des operations longues peut etre indiquee dans un QPro- 
gressDialog ou QProgressBar presente precedemment. QlnputDialog se revele tres pratique 
quand une seule ligne de texte ou un seul chiffre est demande a l'utilisateur. 

Les widgets integres et les boites de dialogue courantes mettent a votre disposition de 
nombreuses fonctionnalites pretes a l'emploi. Des exigences plus particulieres peuvent 
souvent etre satisfaites en configurant les proprietes du widget ou en connectant des signaux a 
des slots et en implementant un comportement personnalise dans les slots. 
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Figure 2.21 
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Figure 2.22 
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Figure 2.24 
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Dans certains cas, il est judicieux de creer un widget personnalise en partant de zero. Qt facilite 
enormement ce processus, et les widgets personnalises peuvent acceder a la meme fonction de 
dessin independante de la plate-forme que les widgets integres de Qt. Les widgets personnalises 
peuvent meme etre integres par le biais du Qt Designer, de sorte qu'ils puissent etre employes 
de la meme facon que les widgets integres de Qt. Le Chapitre 5 vous explique comment creer 
des widgets personnalises. 



3 



Creer des fenetres 
principales 




Au sommaire de ce chapitre 

1/ Derivation de QMain Window 
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Ce chapitre vous apprendra a creer des fenetres principales avec Qt. Vous serez ainsi 
capable de concevoir toute l'interface utilisateur d'une application, constitute de menus, 
de barres d'outils, d'une barre d'etat et d'autant de boites de dialogue que necessaire. 

La fenetre principale d'une application fournit le cadre dans lequel l'interface utilisateur 
est generee. Celle de l'application Spreadsheet illustree en Figure 3.1 servira de base 
pour l'etude dans ce chapitre. Cette application emploie les boites de dialogue Find, 
Go-to-Cell et Sort creees au Chapitre 2. 
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Derriere la plupart des applications GUI se cache du code qui fournit les fonctionnalites sous- 
jacentes - par exemple, le code qui lit et ecrit des fichiers ou qui traite les donnees presentees 
dans 1' interface utilisateur. Au Chapitre 4, vous verrez comment implementer de telles fonc- 
tionnalites, toujours en utilisant 1' application Spreadsheet comme exemple. 



Derivation de QMainWindow 

La fenetre principale d'une application est creee en derivant QMainWindow. La plupart des 
techniques etudiees dans le Chapitre 2 pour creer des boites de dialogue s'appliquent egale- 
ment a la conception de fenetres principales, puisque QDialog et QMainWindow heritent de 
QWidget. 

Les fenetres principales peuvent etre creees a l'aide du Qt Designer, mais dans ce chapitre 
nous effectuerons tout le processus dans du code pour vous montrer le fonctionnement. Si vous 
preferez une approche plus visuelle, consultez le chapitre "Creating Main Windows in Qt 
Designer" dans le manuel en ligne de cet outil. 

Le code source de la fenetre principale de 1' application Spreadsheet est reparti entre 
mainwindow. h et mainwindow. cpp. Commencons par examiner le fichier d'en-tete : 

#ifndef MAINWIND0W_H 
#define MAINWIND0W_H 

#include <QMainWindow> 

class QAction; 
class QLabel; 
class FindDialog; 
class Spreadsheet; 
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class MainWindow : public QMainWindow 
{ 

Q_0BJECT 

public: 

MainWindowf ) ; 

protected : 

void closeEvent(QCloseEvent *event); 

Nous definissons la classe MainWindow comme une sous-classe de QMainWindow. Elle contient 
la macro Q_ OBJECT puisqu'elle fournit ses propres signaux et slots. 

La fonction closeEvent ( ) est une fonction virtuelle dans QWidget qui est appelee automati- 
quement quand l'utilisateur ferme la fenetre. Elle est reimplementee dans MainWindow, de 
sorte que vous puissiez poser a l'utilisateur la question standard "Voulez-vous enregistrer vos 
modifications ?" et sauvegarder les preferences de l'utilisateur sur le disque. 

private slots: 

void newFile( ) ; 
void open() ; 
bool save() ; 
bool saveAsf ) ; 
void find() ; 
void goToCell( ) ; 
void sort() ; 
void about () ; 

Certaines options de menu, telles que File > New (Fichier > Nouveau) et Help > About (Aide > 
A propos), sont implementees comme des slots prives dans MainWindow. La majorite des 
slots ont une valeur de retour void, mais save ( ) et saveAs ( ) retournent une valeur bool. 
La valeur de retour est ignoree quand un slot est execute en reponse a un signal, mais lorsque 
vous invoquez un slot comme une fonction, la valeur de retour est disponible, comme si vous 
aviez appele n'importe quelle fonction C++ ordinaire. 

void openRecentFile() ; 
void updateStatusBarf ) ; 
void spreadsheetModif ied( ) ; 

private: 

void createActions( ) ; 

void createMenus() ; 

void createContextMenu() ; 

void createToolBarsf ) ; 

void createStatusBarf ) ; 

void readSettingsf ) ; 

void writeSettings( ) ; 

bool okToContinue( ) ; 

bool loadFile (const QString &fileName); 

bool saveFile (const QString &fileName); 
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void setCurrentFile (const QString &fileName); 

void updateRecentFileActions( ) ; 

QString strippedName(const QString &f ullFileName) ; 

La fenetre principale a besoin de slots prives et de plusieurs fonctions privees pour prendre en 
charge 1' interface utilisateur. 

Spreadsheet *spreadsheet; 
FindDialog *findDialog; 
QLabel *locationLabel; 
QLabel *formulaLabel; 
QStringList recentFiles; 
QString curFile; 

enum { MaxRecentFiles = 5 }; 

QAction *recentFileActions[MaxRecentFiles] ; 

QAction *separatorAction; 

QMenu *fileMenu; 
QMenu *editMenu; 

QToolBar *fileToolBar; 
QToolBar *editToolBar; 
QAction *newAction; 
QAction *openAction; 

QAction *aboutQtAction; 

}; 

#endif 

En plus de ses slots et fonctions prives, MainWindow possede aussi de nombreuses variables 
privees. Elles seront analysees au fur et a mesure que vous les rencontrerez. 

Nous allons desormais passer en revue 1' implementation : 

#include <QtGui> 
#include "finddialog.h" 
#include "gotocelldialog.h" 
#include "mainwindow.h" 
#include "sortdialog.h" 
#include "spreadsheet . h" 

Nous incluons le fichier d'en-tete <QtGui>, qui contient la definition de toutes les classes Qt 
utilisees dans notre sous-classe. Nous englobons aussi certains fichiers d'en-tete personnalises, 
notamment f inddialog . h, gotocelldialog . h et sortdialog . h du Chapitre 2. 

MainWindow: :MainWindow( ) 
{ 

spreadsheet = new Spreadsheet; 
setCentralWidget(spreadsheet) ; 



createActions( ) ; 
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createMenus( ) ; 
createContextMenu( ) ; 
createToolBarsf) ; 
createStatusBar( ) ; 

readSettingsf ) ; 

findDialog = 0; 

setWindowIcon(QIcon( " : /images/icon. png" ) ) ; 
setCurrentFile( " " ) ; 

} 

Dans le constructeur, nous commencons par creer un widget Spreadsheet et nous le configu- 
rons de maniere a ce qu'il devienne le widget central de la fenetre principale. Le widget central 
se trouve au milieu de la fenetre principale (voir Figure 3.2). La classe Spreadsheet est une 
sous-classe de QTableWidget avec certaines fonctions de tableur, comme la prise en charge 
des formules de tableur. Nous l'implementerons dans le Chapitre 4. 

Nous appelons les fonctions privees createActions ( ), createMenus ( ), createContext- 
Menu(), createToolBars ( ) et createStatusBar ( ) pour configurer le reste de la fenetre 
principale. Nous invoquons egalement la fonction privee readSettings ( ) ann de lire les 
parametres stockes de 1' application. 

Nous initialisons le pointeur findDialog pour que ce soit un pointeur nul ; au premier appel 
de MainWindow: : find ( ), nous creerons l'objet FindDialog. 

A la fin du constructeur, nous definissons l'icone de la fenetre en icon . png, un fichier PNG. 
Qt supporte de nombreux formats d'image, dont BMP, GIF 1 , JPEG, PNG, PNM, XBM et 
XPM. Lappel de QWidget : : setWindowIcon ( ) definit l'icone affichee dans le coin superieur 
gauche de la fenetre. Malheureusement, il n'existe aucun moyen independant de la plate -forme 
pour configurer l'icone de 1' application qui apparait sur le bureau. Les procedures specifiques a 
la plate -forme sont expliquees a l'adresse suivante : 
http://doc.trolltech.eom/4.l/appicon.html. 

Les applications GUI utilisent generalement beaucoup d'images. II existe plusieurs methodes 
pour introduire des images dans une application. Les plus communes sont les suivantes : 

• stacker des images dans des fichiers et les charger a l'execution ; 

• inclure des fichiers XPM dans le code source (Cela fonctionne parce que les fichiers XPM 
sont aussi des fichiers C++ valides.) ; 

• utiliser le mecanisme des ressources de Qt. 



1. La prise en charge du format GIF est desactivee dans Qt par defaut, parce que 1'algorithme de decom- 
pression utilise par les fichiers GIF etait brevete dans certains pays ou les brevets logiciels etaient 
reconnus. Nous pensons que ce brevet est arrive a expiration dans le monde entier. Pour activer le 
support GIF dans Qt, transmettez l'option de ligne de commande -qt-gif au script configure ou 
definissez l'option appropriee dans le programme d' installation de Qt. 
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[~~] Titre de la fenetre l_] [ j [x] 
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Zones de la barre d'outils 
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Widget central 



Barre d'etat 



Dans notre cas, nous employons le mecanisme des ressources de Qt, puisqu'il s'avere plus 
pratique que de charger des fichiers a 1' execution et il est compatible avec n'importe quel 
format d'image pris en charge. Nous avons choisi de stacker les images dans l'arborescence 
source dans un sous-repertoire nomme images. 

Pour utiliser le systeme des ressources de Qt, nous devons creer un fichier de ressources et 
ajouter une ligne au fichier . pro qui identifie le fichier de ressources. Dans cet exemple, nous 
avons appele le fichier de ressources spreadsheet . qrc, nous inserons done la ligne suivante 
dans le fichier .pro : 

RESOURCES = spreadsheet. qrc 

Le fichier de ressources lui-meme utilise un format XML simple. Voici un extrait de celui que 
nous avons employe : 

<!D0CTYPE RCC><RCC version=" 1 .0"> 
<qresource> 

<f ile>images/icon . png</f ile> 

<f ile>images/gotocell . png</f ile> 
</qresource> 
</RCC> 

Les fichiers de ressources sont compiles dans l'executable de 1' application, vous ne pouvez 
done pas les perdre. Quand vous vous referez aux ressources, vous codez le prefixe :/ (double 
point, slash), e'est pourquoi l'icone est specifiee comme suit, :/images/icon . png. Les 
ressources peuvent etre de n'importe quel type (pas uniquement des images) et vous avez la 
possibility de les utiliser a la plupart des emplacements ou Qt attend un nom de fichier. Vous 
les etudierez plus en detail au Chapitre 12. 
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Creer des menus et des barres d'outils 

La majorite des applications GUI modernes proposent des menus, des menus contextuels et 
des barres d'outils. Les menus permettent aux utilisateurs d'explorer l'application et d'appren- 
dre a connaitre de nouvelles commandes, alors que les menus contextuels et les barres d'outils 
fournissent un acces rapide aux fonctionnalites frequemment utilisees. 
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Figure 3.3 

Les menus de l'application Spreadsheet 



Qt simplifie la programmation des menus et des barres d'outils grace a son concept d' action. 
Une action est un element qui peut etre ajoute a n'importe quel nombre de menus et barres 
d'outils. Creer des menus et des barres d'outils dans Qt implique ces etapes : 

• creer et configurer les actions ; 

• creer des menus et y introduire des actions ; 

• creer des barres d'outils et y introduire des actions. 

Dans l'application Spreadsheet, les actions sont creees dans createActions ( ) : 

void MainWindow: : createActions () 
{ 

newAction = new QAction(tr( "&New" ) , this); 
newAction->setIcon(QIcon( " : /images/new. png" ) ) ; 
newAction->setShortcut(tr( "Ctrl+N" ) ) ; 

newAction->setStatusTip(tr( "Create a new spreadsheet file")); 
connect (newAction, SIGNAL(triggered( ) ) , this, SL0T(newFile( ) ) ) ; 

L' action New a un bouton d'acces rapide (New), un parent (la fenetre principale), une icone 
(new. png), un raccourci clavier (Ctrl+N) et une infobulle liee a l'etat. Nous connectons le 
signal triggered ( ) de Taction au slot prive newFile( ) de la fenetre principale, que nous 
implementerons dans la prochaine section. Cette connexion garantit que lorsque l'utilisateur 
selectionne File > New, clique sur le bouton New de la barre d'outils, ou appuie sur Ctrl+N, le 
slot newFile ( ) est appele. 
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Les actions Open, Save et Save As ressemblent beaucoup a Taction New, nous passerons done 
directement a la partie "fichiers ouverts recemment" du menu File : 

for (int i = 0; i < MaxRecentFiles; ++i) { 
recentFileActions[i] = new QAction(this) ; 
recentFileActions[i]->setVisible( false) ; 
connect(recentFileActions[i] , SIGNAL(triggered( ) ) , 
this, SLOT(openRecentFile())); 

} 

Nous alimentons le tableau recentFileActions avec des actions. Chaque action est masquee 
et connectee au slot openRecentFile ( ). Plus tard, nous verrons comment afficher et utiliser 
les actions relatives aux fichiers recents. 

Nous pouvons done passer a Taction Select All : 

selectAHAction = new QAction(tr( "&A11" ) , this); 
selectAHAction->setShortcut(tr("Ctrl+A" ) ) ; 
selectAHAction->setStatusTip(tr( "Select all the cells in the " 

"spreadsheet")) ; 
connect (selectAllAction, SIGNAL(triggered( ) ) , 
spreadsheet, SLOT(selectAll( ) ) ) ; 

Le slot selectAll() est fourni par Tun des ancetres de QTableWidget, QAbstractl- 
temView, nous n'avons done pas a Timplementer nous-memes. 

Continuons done par Taction Show Grid dans le menu Options : 

showGridAction = new QAction(tr( "&Show Grid"), this); 
showGridAct ion- >setCheckable( true) ; 
showGridAction->setChecked(spreadsheet->showGrid( ) ) ; 
showGridAction->setStatusTip(tr( "Show or hide the spreadsheet's " 

"grid")); 

connect(showGridAction, SIGNAL(toggled(bool) ) , 
spreadsheet, SLOT(setShowGrid(bool) ) ) ; 

Show Grid est une action a cocher. Elle est affichee avec une coche dans le menu et est imple- 
mented comme un bouton bascule dans la barre d'outils. Quand Taction est activee, le compo- 
sant Spreadsheet affiche une grille. Nous initialisons Taction avec la valeur par defaut du 
composant Spreadsheet, de sorte qu'elles soient synchronisers au demarrage. Puis nous 
connectons le signal toggled (bool) de Taction Show Grid au slot setShowGrid (bool) du 
composant Spreadsheet, qu'il herite de QTableWidget. Lorsque cette action est ajoutee a un 
menu ou a une barre d'outils, Tutilisateur peut activer ou desactiver Taffichage de la grille. 

Les actions Show Grid et Auto-Recalculate sont des actions a cocher independantes. Qt 
prend aussi en charge des actions qui s'excluent mutuellement par le biais de la classe 
QActionGroup. 
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aboutQtAction = new QAction(tr( "About &Qt"), this); 
aboutQtAction->setStatusTip(tr( "Show the Qt library's About box")); 
connect (aboutQtAction, SIGNAL(triggered( ) ) , qApp, SLOT(aboutQt( ) ) ) ; 



} 



Concernant Taction About Qt, nous utilisons le slot aboutQtl 
accessible via la variable globale qApp. 



de l'objet QApplication, 



Figure 3.4 

About Qt 
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also available for embedded devices as Qtopia Core. 



Qt is a Trolltecn product See http://w 
for more information. 



. tcolltech. com/ qt/ 



Maintenant que nous avons cree les actions, nous pouvons poursuivre en concevant un systeme 
de menus qui les englobe : 

void MainWindow: :createMenus( ) 
{ 

fileMenu = menuBar( )->addMenu(tr( "&File" ) ) ; 
fileMenu->addAction(newAction) ; 
f ileMenu->addAction(openAction) ; 
f ileMenu->addAction(saveAction) ; 
f ileMenu->addAction(saveAsAction) ; 
separatorAction = f ileMenu->addSeparator( ) ; 
for (int i = 0; i < MaxRecentFiles; ++i) 

fileMenu->addAction(recentFileActions[i] ) ; 
f ileMenu->addSeparator( ) ; 
f ileMenu->addAction(exitAction) ; 

Dans Qt, les menus sont des instances de QMenu. La fonction addMenu ( ) cree un widget 
QMenu avec le texte specine et l'ajoute a la barre de menus. La fonction QMainWin- 
dow: :menuBar() retourne un pointeur vers un QMenuBar. La barre de menus est creee la 
premiere fois que menu Bar ( ) est appele. 

Nous commencons par creer le menu File, puis nous y ajoutons les actions New, Open, Save et 
Save As. Nous inserons un separateur pour regrouper visuellement des elements connexes. 
Nous utilisons une boucle for pour ajouter les actions (masquees a l'origine) du tableau 
recentFileActions, puis nous ajoutons Taction exitAction a la fin. 
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Nous avons conserve un pointeur vers l'un des separateurs. Nous avons ainsi la possibilite de 
le masquer (s'il n'y a pas de fichiers recents) ou de l'afficher, parce que nous ne voulons pas 
afficher deux separateurs sans rien entre eux. 

editMenu = menuBar()->addMenu(tr("&Edit")) ; 
editMenu->addAction(cutAction) ; 
editMenu->addAction(copyAction) ; 
editMenu->addAction(pasteAction) ; 
editMenu->addAction(deleteAction) ; 

selectSubMenu = editMenu->addMenu(tr( "&Select" ) ) ; 
selectSubMenu->addAction(selectRowAction) ; 
selectSubMenu- >addAct ion (selectColumnAct ion) ; 
selectSubMenu->addAction(selectAllAction) ; 

editMenu->addSeparator( ) ; 
editMenu- >addAct ion (findAct ion) ; 
editMenu->addAction(goToCellAction) ; 

Occupons-nous desormais de creer le menu Edit, en ajoutant des actions avec QMenu : :add- 
Action() comme nous l'avons fait pour le menu File et en ajoutant le sous-menu avec 
QMenu : : addMenu ( ) a l'endroit ou nous souhaitons qu'il apparaisse. Le sous-menu, comme le 
menu auquel il appartient, est un QMenu. 

toolsMenu = menuBarf )->addMenu(tr( "&Tools" ) ) ; 
toolsMenu->addAction ( recalculateAction ) ; 
toolsMenu- >addAct ion ( so rtAct ion) ; 

optionsMenu = menuBar()->addMenu(tr("&Options")) ; 
optionsMenu->addAction(showGridAction) ; 
optionsMenu->addAction(autoRecalcAction) ; 

menuBar()->addSeparator() ; 

helpMenu = menuBar()->addMenu(tr("&Help")) ; 
helpMenu->addAction(aboutAction) ; 
helpMenu->addAction(aboutQtAction) ; 

} 

Nous creons les menus Tools, Options et Help de maniere similaire. Nous introduisons un 
separateur entre les menus Options et Help. En styles Motif et CDE, le separateur aligne le 
menu Help a droite ; dans les autres styles, le separateur est ignore. 

Figure 3.5 
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void MainWindow: :createContextMenu( ) 
{ 

spreadsheet->addAction(cutAction) ; 
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spreadsheet->addAction(copyAction) ; 
spreadsheet->addAction(pasteAction) ; 

spreadsheet->setContextMenuPolicy(Qt: :ActionsContextMenu) ; 

} 

Tout widget Qt peut avoir une liste de QAction associee. Pour proposer un menu contextuel 
pour T application, nous ajoutons les actions souhaitees au widget Spreadsheet et nous defi- 
nissons la strategie du menu contextuel de ce widget de sorte qu'il affiche un menu contextuel 
avec ces actions. Les menus contextuels sont invoques en cliquant du bouton droit sur un 
widget ou en appuyant sur une touche specifique a la plate-forme. 

Figure 3.6 

Le menu contextuel de 
V application Spreadsheet 
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II existe un moyen plus elabore de proposer des menus contextuels : implementer a nouveau la 
fonction QWidget : : contextMenuEvent ( ), creer un widget QMenu, l'alimenter avec les 
actions voulues et appeler exec ( ) . 

void MainWindow: :createToolBars() 
{ 

fileToolBar = addToolBar(tr( "&File" ) ) ; 
f ileToolBar->addAction(newAction) ; 
f ileToolBar->addAction(openAction) ; 
f ileToolBar->addAction(saveAction) ; 

editToolBar = addToolBar(tr("&Edit")) ; 
editToolBar->addAction(cutAction) ; 
editToolBar->addAction(copyAction) ; 
editToolBar->addAction(pasteAction) ; 
editToolBar->addSeparator( ) ; 
editToolBar->addAction(findAction) ; 
editToolBar->addAction(goToCellAction) ; 

} 

La creation de barres d'outils ressemble beaucoup a celle des menus. Nous concevons les 
barres d'outils File et Edit. Comme un menu, une barre d'outils peut posseder des sepa- 
rate urs. 



Figure 3.7 

Les barres d'outils de 
V application Spreadsheet 
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Configurer la barre d'etat 



Lorsque les menus et les barres d'outils sont termines, vous etes pret a vous charger de la barre 
d'etat de l'application Spreadsheet. 

Normalement, cette barre d'etat contient deux indicateurs : l'emplacement et la formule de la 
cellule en cours. 



Fi § Ure 3 - 8 fir- |=A1+A2+A3 

La barre d'etat de Vappli- Normal 
cation Spreadsheet 



Open an existing spreadsheet file 

Infobulle sur I'etat 

File saved 
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Le constructeur de MainWindowappelle createStatusBar ( ) pour configurer la barre d'etat : 

void MainWindow: :createStatusBar() 
{ 

locationLabel = new QLabel(" W999 "); 
locationLabel->setAlignment(Qt: :AlignHCenter) ; 
locationLabel->setMinimumSize( locationLabel- >sizeHint () ) ; 

f ormulaLabel = new QLabel; 
f ormulaLabel->setIndent(3) ; 

statusBar ( ) ->addWidget (locationLabel) ; 
statusBar ()~>addWidget(f ormulaLabel, 1 ) ; 

connect(spreadsheet, SIGNAL(currentCellChanged(int, int, int, int)), 

this, SLOT(updateStatusBar() ) ) ; 
connect (spreadsheet, SIGNAL (modif ied( ) ) , 

this, SLOT(spreadsheetModif ied( ) ) ) ; 

updateStatusBarf ) ; 

} 

La fonction QMainWindow: : statusBar () retourne un pointeur vers la barre d'etat. (La barre 
d'etat est creee la premiere fois que statusBar ( ) est appelee.) Les indicateurs d'etat sont 
simplement des QLabel dont nous modifions le texte des que cela s'avere necessaire. 
Nous avons ajoute une indentation a f ormulaLabel, pour que le texte qui y est affiche 
soit legerement decale du bord gauche. Quand les QLabel sont ajoutes a la barre d'etat, ils sont 
automatiquement reparentes pour devenir des enfants de cette derniere. 

La Figure 3.8 montre que les deux etiquettes ont des exigences differentes s'agissant de l'espace. 
L'indicateur relatif a l'emplacement de la cellule ne necessite que tres peu de place, et lorsque 
la fenetre est redimensionnee, tout espace supplementaire devrait revenir a l'indicateur de la 
formule de la cellule sur la droite. Vous y parvenez en specifiant un facteur de redimensionnement 
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de 1 dans l'appel QStatusBar : : addWidget ( ) de l'etiquette de la formule. L'indicateur 
d' emplacement presente un facteur de redimensionnement par defaut de 0, ce qui signirie qu'il 
prefere ne pas etre etire. 

Quand QStatusBar organise l'affichage des widgets indicateur, il essaie de respecter la taille 
ideale de chaque widget specifiee par QWidget : : sizeHint ( ), puis redimensionne tout 
widget etirable pour combler l'espace disponible. La taille ideale d'un widget depend du 
contenu de ce widget et varie en fonction des modifications du contenu. Pour eviter de redi- 
mensionner constamment l'indicateur d' emplacement, nous configurons sa taille minimale de 
sorte qu'elle suffise pour contenir le texte le plus grand possible ("W999"), avec tres peu 
d'espace supplementary. Nous definissons aussi son alignement en Qt : : AlignHCenter pour 
centrer le texte horizontalement. 

Vers la fin de la fonction, nous connectons deux des signaux de Spreadsheet a deux des slots 
de MainWindow : updateStatusBar ( ) et spreadsheetModif ied ( ). 

void MainWindow: : updateStatusBar( ) 
{ 

locationLabel->setText(spreadsheet->currentLocation( ) ) ; 
formulaLabel->setText (spreadsheet ->current Formula ( ) ) ; 

} 

Le slot updateStatusBar ( ) met a jour les indicateurs relatifs a l'emplacement et a la 
formule de la cellule. II est invoque des que l'utilisateur deplace le curseur vers une autre 
cellule. Le slot sert egalement de fonction ordinaire a la fin de createStatusBar ( ) pour 
initialiser les indicateurs. II se revele necessaire puisque Spreadsheet n'emet pas le signal 
currentCellChanged ( ) au demarrage. 

void MainWindow: : spreadsheetModif ied () 
{ 

setWindowModif ied(true) ; 
updateStatusBar) ) ; 

} 

Le slot spreadsheetModif ied ( ) definit la propriete windowModif ied en true, ce qui met a 
jour la barre de titre. La fonction met egalement a jour les indicateurs d'emplacement et de 
formule, pour qu'ils refletent les circonstances actuelles. 



Implementer le menu File 

Dans cette section, nous allons implementer les slots et les fonctions privees necessaires pour 
faire fonctionner les options du menu File et pour gerer la liste des fichiers ouverts recemment. 

void MainWindow: : newFile( ) 
{ 

if (okToContinue( ) ) { 
spreadsheet->clear( ) ; 
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setCurrentFile( " " ) ; 

} 

} 

Le slot newFile( ) est appele lorsque l'utilisateur clique sur l'option File > New ou sur le 
bouton New de la barre d'outils. La fonction privee okToContinue ( ) demande a l'utilisateur 
s'il desire enregistrer ses modifications, si certaines modifications n'ont pas ete sauvegardees 
(voir Figure 3.9). Elle retourne true si l'utilisateur choisit Yes ou No (vous enregistrez le 
document en appuyant sur Yes), et false si l'utilisateur clique sur Cancel. La fonction 
Spreadsheet : : clear ( ) efface toutes les cellules et formules du tableur. La fonction privee 
setCurrentFile ( ) met a jour le titre de la fenetre pour indiquer qu'un document sans titre 
est en train d'etre modifie, en plus de configurer la variable privee cur File et de mettre a jour 
la liste des fichiers ouverts recemment. 



Figure 3.9 
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bool MainWindow: : okToContinue ( ) 
{ 

if (isWindowModified( ) ) { 

int r = QMessageBox: :warning(this, tr( "Spreadsheet" ) , 
trf'The document has been modified. \n" 

"Do you want to save your changes?"), 
QMessageBox: : Yes | QMessageBox: :Default, 
QMessageBox: :No, 

QMessageBox: :Cancel | QMessageBox: :Escape) ; 
if (r == QMessageBox: :Yes) { 

return save( ) ; 
} else if (r == QMessageBox: :Cancel) { 

return false; 

} 

} 

return true; 

} 

Dans okToContinue ( ), nous controlons l'etat de la propriete windowModif ied. S'il est 
correct, nous affichons la boite de message illustree en Figure 3.9. Celle-ci propose les boutons 
Yes, No et Cancel. QMessageBox : : Default definit le bouton Yes comme bouton par defaut. 
QMessageBox : : Escape definit la touche Echap comme synonyme de Cancel. 

Lappel de warning ( ) peut sembler assez complexe de prime abord, mais la syntaxe generale 
est simple : 

QMessageBox: :warning(parent, titre, message, boutonO, boutonl, ...); 
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QMessageBox propose aussi information ( ), question() et critical(), chacun posse- 
dant sa propre icone. 

Figure 3.10 
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void MainWindow: :open() 
{ 

if (okToContinue( ) ) { 

QString fileName = QFileDialog : :getOpenFileName(this, 

tr( "Open Spreadsheet" ) , 
tr( "Spreadsheet files (*.sp)")); 

if (IfileName.isEmptyO) 
loadFile(f ileName) ; 

} 

} 

Le slot open ( ) correspond a File > Open. Comme newFile ( ), il appelle d'abord okToConti- 
nue() pour gerer toute modification non sauvegardee. Puis il utilise la fonction statique 
QFileDialog : : getOpenFileName ( ) tres pratique pour demander le nom du nouveau fichier 
a l'utilisateur. La fonction ouvre une boite de dialogue, permet a l'utilisateur de choisir un 
fichier et retourne le nom de ce dernier - ou une chaine vide si l'utilisateur clique sur Cancel. 

Le premier argument de QFileDialog : : getOpenFileName ( ) est le widget parent. La rela- 
tion parent-enfant ne signifie pas la meme chose pour les boites de dialogue et pour les autres 
widgets. Une boite de dialogue est toujours une fenetre en soi, mais si elle a un parent, elle est 
centree en haut de ce dernier par defaut. Une boite de dialogue enfant partage aussi l'entree de 
la barre des taches de son parent. 

Le second argument est le titre que la boite de dialogue doit utiliser. Le troisieme argument 
indique le repertoire depuis lequel il doit demarrer, dans notre cas le repertoire en cours. 

Le quatrieme argument specifie les filtres de fichier. Un filtre de fichier est constitue d'un texte 
descriptif et d'un modele generique. Si nous avions pris en charge les fichiers de valeurs sepa- 
rees par des virgules et les fichiers Lotus 1-2-3, en plus du format de fichier natif de 
Spreadsheet, nous aurions employe le filtre suivant : 

tr( "Spreadsheet files (*.sp)\n" 

"Comma-separated values files (*.csv)\n" 
"Lotus 1-2-3 files (*.wk1 *.wks)") 

La fonction privee loadFile( ) a ete invoquee dans open( ) pour charger le fichier. Nous en 
avons fait une fonction independante, parce que nous aurons besoin de la meme fonctionnalite 
pour charger les fichiers ouverts recemment : 

bool MainWindow: : loadFile(const QString &fileName) 
{ 

if ( !spreadsheet->readFile(fileName) ) { 
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statusBar()->showMessage(tr("Loading canceled"), 2000); 
return false; 

} 

setCurrentFile(fileName) ; 

statusBar( ) ->showMessage(tr( "File loaded"), 2000); 
return true; 

} 

Nous utilisons Spreadsheet : : readFile ( ) pour lire le fichier sur le disque. Si le chargement 
est effectue avec succes, nous appelons setCurrentFile ( ) pour mettre a jour le titre de la 
fenetre ; sinon, Spreadsheet : : readFile ( ) aurait deja informe l'utilisateur du probleme par 
une boite de message. En general, il est recommande de laisser les composants de bas niveau 
emettre des messages d'erreur, parce qu'ils peuvent apporter des details precis sur ce qui s'est 
passe. 

Dans les deux cas, nous affichons un message dans la barre d'etat pendant 2 secondes (2000 milli- 
secondes) pour informer l'utilisateur des taches effectuees par l'application. 

bool MainWindow: : save( ) 
{ 

if (curFile.isEmpty() ) { 

return saveAs() ; 
} else { 

return saveFile(curFile) ; 

} 

} 

bool MainWindow: : saveFile(const QString &fileName) 
{ 

if ( !spreadsheet->writeFile(f ileName) ) { 

statusBar()->showMessage(tr("Saving canceled"), 2000); 
return false; 

} 

setCurrentFile (f ileName) ; 

statusBar()->showMessage(tr("File saved"), 2000); 
return true; 

} 

Le slot save ( ) correspond a File > Save. Si le fichier porte deja un nom puisque il a deja ete 
ouvert ou enregistre, save ( ) appelle saveFile ( ) avec ce nom ; sinon il invoque simplement 
saveAs( ). 

bool MainWindow: :saveAs() 
{ 

QString fileName = QFileDialog: :getSaveFileName(this, 

tr( "Save Spreadsheet" ) , 
tr( "Spreadsheet files (*.sp)")); 

if (fileName. isEmptyO) 
return false; 
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return saveFile(fileName) ; 

} 

Le slot saveAs ( ) correspond a File > Save As. Nous appelons QFileDialog : : getSave- 
FileName ( ) pour que l'utilisateur indique un nom de fichier. Si l'utilisateur clique sur 
Cancel, nous retournons false, qui est ensuite transmis a son appelant (save() ou okTo- 
Continue( )). 

Si le fichier existe deja, la fonction getSaveFileName ( ) demandera a l'utilisateur de 
confirmer qu'il veut bien le remplacer. Ce comportement peut etre modifie en transmettant 
QFileDialog: : DontConf irmOverwrite comme argument supplemental a getSave- 
FileName ( ) . 

void MainWindow: :closeEvent(QCloseEvent *event) 
{ 

if (okToContinue( ) ) { 

writeSettings( ) ; 

event->accept() ; 
} else { 

event->ignore( ) ; 

} 

} 

Quand l'utilisateur clique sur File > Exit ou sur le bouton de fermeture dans la barre de titre de 
la fenetre, le slot QWidget : : close ( ) est invoque. Un evenement "close" est done envoye au 
widget. En implementant a nouveau QWidget : : closeEvent ( ), nous avons la possibility de 
fermer la fenetre principale et de decider si nous voulons aussi fermer la fenetre ou non. 

Si certaines modifications n'ont pas ete enregistrees et si l'utilisateur selectionne Cancel, nous 
"ignorons" P evenement et la fenetre n'en sera pas affectee. En temps normal, nous acceptons 
P evenement ; Qt masque done la fenetre. Nous invoquons egalement la fonction privee 
writeSettings ( ) arm de sauvegarder les parametres en cours de P application. 

Quand la derniere fenetre est fermee, P application se termine. Si necessaire, nous pouvons 
desactiver ce comportement en configurant la propriete quitOnLastWindowClosed de 
QApplication en false, auquel cas Papplication continue a etre executee jusqu'a ce que 
nous appelions QApplication : : quit ( ). 

void MainWindow: : setCurrentFile(const QString &fileName) 
{ 

curFile = fileName; 
setWindowModif ied (false) ; 

QString shownName = "Untitled"; 

if ( !curFile.isEmpty( ) ) { 

shownName = strippedName(curFile) ; 
recentFiles.removeAll(curFile) ; 
recentFiles.prepend(curFile) ; 
updateRecentFileActions ( ) ; 

} 
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setWindowTitle(tr( "%1 [*] - %2" ) .arg(shownName) 

.arg(tr( "Spreadsheet " ) ) ) ; 

} 

QString MainWindow: :strippedName(const QString &f ullFileName) 
{ 

return QFileInfo(f ullFileName) .fileName( ) ; 

} 

Dans setCurrentFile ( ), nous definissons la variable privee curFile qui stocke le nom du 
fichier en cours de modification. Avant d'afficher le nom du fichier dans la barre de titre, nous 
supprimons le chemin d'acces du fichier avec strippedName ( ) pour le rendre plus convivial. 

Chaque QWidget possede une propriete windowModif ied qui doit etre definie en true si le 
document presente des modifications non sauvegardees et en false dans les autres cas. Sous 
Mac OS X, les documents non sauvegardes sont indiques par un point dans le bouton de 
fermeture de la barre de titre de la fenetre ; sur les autres plates-formes, ils sont indiques par un 
asterisque apres le nom de fichier. Qt se charge automatiquement de ce comportement, tant que 
nous mettons a jour la propriete windowModif ied et que nous placons le marqueur "[*]" dans 
le titre de la fenetre a l'endroit oil nous souhaitons voir apparaitre 1' asterisque. 

Le texte transmis a la fonction setWindowTitle ( ) etait le suivant : 

tr ( "%1 [ *] - %2" ) .arg(shownName) 

.arg(tr( "Spreadsheet" ) ) 

La fonction QString: :arg( ) remplace le parametre "%n" de numero le plus bas par son 
argument et retourne la chaine ainsi obtenue. Dans ce cas, arg ( ) est utilise avec deux parame- 
tres "%n". Le premier appel de arg( ) remplace ; le second appel remplace "%2".Si le 
nom de fichier est "budget.sp" et qu'aucun fichier de traduction n'est charge, la chaine obtenue 
serait "budget.sp[*] - Spreadsheet". II aurait ete plus simple d'ecrire 

setWindowTitle(shownName + tr("[*] - Spreadsheet")); 
mais arg ( ) offre une plus grande souplesse pour les traducteurs. 

S'il existe un nom de fichier, nous mettons a jour recentFiles, la liste des fichiers ouverts 
recemment. Nous invoquons removeAll( ) pour supprimer toutes les occurrences du nom de 
fichier dans la liste afin d'eviter les copies ; puis nous appelons prepend ( ) pour ajouter le 
nom de fichier en tant que premier element. Apres la mise a jour de la liste, nous appelons 
la fonction privee updateRecentFileActions ( ) de maniere a mettre a jour les entrees dans 
le menu File. 

void MainWindow: : updateRecentFileActions () 
{ 

QMutableStringListlterator i(recentFiles) ; 
while (i.hasNext()) { 

if (IQFile: :exists(i.next())) 
i. remove ( ) ; 
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} 



for (int j = 0; j < MaxRecentFiles; ++j) { 
if (j < recentFiles.count()) { 
QString text = tr( %2") 
■ arg(j + 1) 

.arg(strippedName( recentFiles! j ] ) ) ; 
recentFileActions[j ]->setText(text) ; 
recentFileActions[ j ]->setData(recentFiles[ j ] ) ; 
recentFileActions[ j ]->setVisible(true) ; 
} else { 

recentFileActions[ j ]->setVisible(false) ; 



} 



} 

separatorAction->setVisible( ! recentFiles. isEmpty( ] 



Nous commencons par supprimer tout fichier qui n'existe plus a l'aide d'un iterateur de style 
Java. Certains fichiers peuvent avoir ete utilises dans une session anterieure, mais ont ete 
supprimes depuis. La variable recentFiles est de type QStringList (liste de QString). Le 
Chapitre 11 etudie en detail les classes conteneur comme QStringList vous expliquant 
comment elles sont liees a la bibliotheque C++ STL (Standard Template Library), et vous 
explique comment employer les classes d'iterateurs de style Java dans Qt. 

Nous parcourons ensuite a nouveau la liste des fichiers, mais cette fois-ci en utilisant une 
indexation de style tableau. Pour chaque fichier, nous creons une chaine composee d'un carac- 
tere &, d'un chiffre ( j + 1), d'un espace et du nom de fichier (sans son chemin d'acces). Nous 
definissons Taction correspondante pour qu'elle utilise ce texte. Par exemple, si le premier 
fichier etait C:\My Documents\tab04.sp, le texte de la premiere action serait "&1 tab04.sp". 

Figure 3.11 

Le menu File 
avec les fichiers 
ouverts recemment 



recentFileActions[0] - 
recentFileActions[1] - 
recentFileActions[2] - 
recentFileActions[3] - 
recentFileActions[4] - 



New Ctrl+N 

t> Open... Ctrl+O 

B Save Ctrl+S 

Save As... 
— ►Itab04.sp 
— *-2 Sales 2003. sp 
— ►3 Annual Report. sp 
— ^4 population. sp 
— ^5 Customers. sp 

Exit Ctrl+Q 



separatorAction 



Chaque action peut avoir un element "donnee" associe de type QVariant. Le type QVariant 
peut contenir des valeurs de plusieurs types C++ et Qt ; c'est explique au Chapitre 11. Ici, nous 
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stockons le nom complet du fichier dans T element "donnee" de Taction, pour pouvoir le recuperer 
facilement par la suite. Nous configurons egalement Taction de sorte qu'elle soit visible. 

S'il y a plus d'actions de fichiers que de fichiers recents, nous masquons simplement les actions 
supplementaires. Enfin, s'il y a au moins un fichier recent, nous definissons le separateur pour 
qu'il s'affiche. 

void MainWindow: :openRecentFile() 
{ 

if (okToContinuef ) ) { 

QAction *action = qobject_cast<QAction *>(sender( ) ) ; 
if (action) 

loadFile(action->data( ) .toString( ) ) ; 

} 

} 

Quand Tutilisateur selectionne un fichier recent, le slot openRecentFile ( ) est appele. La fonc- 
tion okToContinue ( ) est executee si des changements n'ont pas ete sauvegardes, et si Tutilisateur 
n'annule pas, nous identifions quelle action a appele le slot grace a QObj ect : : sender ( ). 

La fonction qobject_cast<T>( ) accomplit une conversion dynamique basee sur les meta- 
informations generees par moc, le compilateur des meta-objets de Qt. Elle retourne un pointeur 
vers la sous-classe QObj ect demandee, ou 0 si Tobjet n'a pas pu etre converti dans ce type. 
Contrairement a dynamic_cast<T> ( ) du langage C++ standard, qob j ect_cast<T> ( ) de Qt 
fonctionne correctement dans les bibliotheques dynamiques. Dans notre exemple, nous utili- 
sons qob] ect_cast<T> ( ) pour convertir un pointeur QObj ect en une action QAction. Si la 
conversion a ete effectuee avec succes (ce devrait etre le cas), nous appelons loadFile( ) 
avec le nom complet du fichier que nous extrayons des donnees de Taction. 

Notez qu'etant donne que nous savons que Texpediteur est de type QAction, le programme 
fonctionnerait toujours si nous avions utilise static_cast<T>( ) ou une conversion tradition- 
nelle de style C. Consultez la section "Conversions de type" en Annexe B pour connaitre les 
diverses conversions C++. 



Utiliser des boites de dialogue 

Dans cette section, nous allons vous expliquer comment utiliser des boites de dialogue dans 
Qt - comment les creer et les initialiser, les executer et repondre aux selections effectuees par 
Tutilisateur interagissant avec elles. Nous emploierons les boites de dialogue Find, Go-to-Cell 
et Sort creees au Chapitre 2. Nous creerons aussi une boite simple About. 

Nous commencons par la boite de dialogue Find. Nous voulons que Tutilisateur puisse basculer a 
volonte entre la fenetre principale Spreadsheet et la boite de dialogue Find, cette derniere doit 
done etre non modale. Une fenetre non modale est executee independamment de toute autre 
fenetre dans T application. 
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Figure 3.12 

La boite de dialogue Find 
de I' application 
Spreadsheet 



Find what: I Waldo 



X Match case 

U Search backward 



Find 



Close 



Lorsque des boites de dialogue non modales sont creees, leurs signaux sont normalement 
connectes aux slots qui repondent aux interactions de l'utilisateur. 

void MainWindow: :f ind( ) 
{ 

if ( IfindDialog) { 

findDialog = new FindDialog(this) ; 

connect (findDialog, SIGNAL(findNext(const QString &, 

Qt: :CaseSensitivity) ) , 
spreadsheet, SLOT(findNext(const QString &, 

Qt : :CaseSensitivity) ) ) ; 
connect (findDialog, SIGNAL(f indPrevious (const QString &, 

Qt : :CaseSensitivity) ) , 
spreadsheet, SLOT(findPrevious(const QString &, 

Qt : :CaseSensitivity) ) ) ; 

} 

f indDialog->show( ) ; 

f indDialog->activateWindow( ) ; 

} 

La boite de dialogue Find est une fenetre qui permet a l'utilisateur de rechercher du texte dans 
le tableur. Le slot find ( ) est appele lorsque l'utilisateur clique sur Edit > Find pour ouvrir la 
boite de dialogue Find. A ce stade, plusieurs scenarios sont possibles : 

• C'est la premiere fois que l'utilisateur appelle la boite de dialogue Find. 

• La boite de dialogue Find a deja ete appelee auparavant, mais l'utilisateur l'a fermee. 

• La boite de dialogue Find a deja ete appelee auparavant et est toujours affichee. 

Si la boite de dialogue Find n'existe pas encore, nous la creons et nous connectons ses signaux 
f indNext ( ) et f indPrevious ( ) aux slots Spreadsheet correspondants. Nous aurions aussi 
pu creer la boite de dialogue dans le constructeur de MainWindow, mais ajourner sa creation 
rend le demarrage plus rapide. De meme, si la boite de dialogue n'est jamais utilisee, elle n'est 
jamais creee, ce qui vous fait gagner du temps et de la memoire. 

Nous invoquons ensuite show( ) et activateWindow( ) pour nous assurer que la fenetre est 
visible et active. Un seul appel de show() est suffisant pour afficher et activer une fenetre 
masquee, mais la boite de dialogue Find peut etre appelee quand sa fenetre est deja visible, 
auquel cas show( ) ne fait rien et activateWindow( ) est necessaire pour activer la fenetre. 
Vous auriez aussi pu ecrire 

if (f indDialog->isHidden( ) ) { 
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f indDialog->show( ) ; 
} else { 

f indDialog->activateWindow( ) ; 

} 

Ce code revient a regarder des deux cotes d'une route a sens unique avant de traverser. 

Nous allons a present analyser la boite de dialogue Go-to-Cell. Nous voulons que l'utilisateur 
l'ouvre, l'utilise, puis la ferme sans pouvoir basculer vers d'autres fenetres dans l'application. 
Cela signifie que la boite de dialogue Go-to-Cell doit etre modale. Une fenetre modale est une 
fenetre qui s'affiche quand elle est appelee et bloque l'application. Tout autre traitement ou 
interaction est impossible tant que la fenetre n'est pas fermee. Les boites de dialogue d'ouver- 
ture de fichier et les boites de message utilisees precedemment etaient modales. 



Figure 3.13 

La boite de dialogue 
Go-to-Cell de l'appli- 
cation Spreadsheet 



Go to Cell 




Une boite de dialogue n'est pas modale si elle est appelee a l'aide de show( ) (a moins que 
nous appelions setModal( ) au prealable pour la rendre modale) ; elle est modale si elle est 
invoquee avec exec ( ) . 

void MainWindow: :goToCell() 
{ 

GoToCellDialog dialog(this) ; 
if (dialog.execf)) { 

QString str = dialog. lineEdit->text() .toUpper() ; 

spreadsheet->setCurrentCell(str.mid(1 ) .toInt( ) - 1, 

str[0] .unicode() - 'A' ) ; 

} 

} 

La fonction QDialog: :exec() retourne une valeur true (QDialog: : Accepted) si la boite 
de dialogue est acceptee, et une valeur false (QDialog: : Rejected) dans les autres cas. 
Souvenez-vous que lorsque nous avons cree la boite de dialogue Go-to-Cell avec le Qt Designer 
au Chapitre 2, nous avons connecte OK a accept ( ) et Cancel a re j ect ( ) . Si l'utilisateur clique 
sur OK, nous definissons la cellule actuelle avec la valeur presente dans l'editeur de lignes. 

La fonction QTableWidget : : setCurrentCell( ) recoit deux arguments: un index des 
lignes et un index des colonnes. Dans l'application Spreadsheet, la cellule Al correspond a la 
cellule (0, 0) et la cellule B27 a la cellule (26, 1). Pour obtenir l'index des lignes du QString 
retourne par QLineEdit : : text ( ), nous devons extraire le nombre de lignes avec 
QString: :mid() (qui retourne une sous-chaine allant du debut a la fin de la chaine), la 
convertir en type int avec QString : : tolnt ( ) et soustraire 1. Pour le nombre de colonnes, 
nous soustrayons la valeur numerique de 'A' de la valeur numerique du premier caractere en 
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majuscule de la chaine. Nous savons que la chaine aura le bon format parce que QRegExp- 
Validator cree pour la boite de dialogue n'autorise l'activation du bouton OK que s'il y a une 
lettre suivie par 3 chiffres maximum. 

La fonction goToCell() differe de tout le code etudie jusqu'a present, puisqu'elle cree un 
widget (GoToCellDialog) sous la forme d'une variable sur la pile. En ajoutant une ligne, 
nous aurions pu utiliser tout aussi facilement new et delete : 

void MainWindow: :goToCell() 
{ 

GoToCellDialog *dialog = new GoToCellDialog(this) ; 
if (dialog->exec( ) ) { 

QString str = dialog->lineEdit->text() .toUpper() ; 

spreadsheet->setCurrentCell(str.mid(1 ) .toInt( ) - 1, 

str[0] .unicode() - 'A' ) ; 

} 

delete dialog; 

} 

La creation de boites de dialogue modales (et de menus contextuels dans des reimplementa- 
tions QWidget : : contextMenuEvent ( )) sur la pile est un modele de programmation courant, 
parce qu'en regie generale, nous n'avons plus besoin de la boite de dialogue (ou du menu) 
apres l'avoir utilisee, et elle sera automatiquement detruite a la fin de la portee dans laquelle 
elle evolue. 

Examinons maintenant la boite de dialogue Sort. Celle-ci est une boite de dialogue modale qui 
permet a l'utilisateur de trier la zone selectionnee sur les colonnes qu'il specifie. La Figure 3.14 
montre un exemple de tri, avec la colonne B comme cle de tri primaire et la colonne A comme 
cle de tri secondaire (toutes les deux par ordre croissant). 

Figure 3.14 
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(b) Avant le tri 



(b) Apres le tri 



void MainWindow: : sort () 
{ 

SortDialog dialog (this) ; 

QTableWidgetSelectionRange range = spreadsheet->selectedRange( ) ; 
dialog . setColumnRange ( 'A' + range. leftColumn() , 
'A' + range. rightColumn()) ; 

if (dialog. exec () ) { 



68 Qt4 et C++ : Programmation d'interfaces GUI 



SpreadsheetCompare compare; 
compare. keys[0] = 

dialog. primaryColumnCombo->current I ndex ( ) ; 
compare. keys[1 ] = 

dialog. secondaryColumnCombo->currentIndex( ) - 1; 
compare. keys[2] = 

dialog. tertiaryColumnCombo->currentIndex() - 1; 
compare. ascending[0] = 

(dialog. primaryOrderCombo->currentIndex() == 0); 
compare. ascending[1 ] = 

(dialog. secondaryOrderCombo->currentIndex() == 0); 
compare. ascending[2] = 

(dialog .tertiaryOrderCombo->currentIndex( ) == 0); 
spreadsheet->sort(compare) ; 

} 

} 

Le code dans sort ( ) suit un modele similaire a celui utilise pour goToCell ( ) : 

• Nous creons la boite de dialogue sur la pile et nous l'initialisons. 

• Nous ouvrons la boite de dialogue avec exec ( ) . 

• Si l'utilisateur clique sur OK, nous extrayons les valeurs saisies par ce dernier a partir des 
widgets de la boite de dialogue et nous les utilisons. 

L'appel de setColumnRange ( ) definit les colonnes disponibles pour le tri sur les colonnes 
selectionnees. Par exemple, en utilisant la selection illustree en Figure 3.14, range. left- 
Column ( ) produirait 0, ce qui fait 'A' + 0 = 'A', et range . rightColumn ( ) produirait 2, ce 
quifait'A + 2 = 'C'. 

L'objet compare stocke les cles de tri primaire, secondaire et tertiaire, ainsi que leurs ordres de 
tri. (Nous verrons la definition de la classe SpreadsheetCompare dans le prochain chapitre.) 
L'objet est employe par Spreadsheet: : sort ( ) pour comparer deux lignes. Le tableau keys 
stocke les numeros de colonne des cles. Par exemple, si la selection s'etend de C2 a E5, la 
colonne C correspond a la position 0. Le tableau ascending conserve l'ordre associe a chaque 
cle comme une valeur bool. QComboBox: : currentlndex ( ) retourne l'index de l'element 
selectionne, en commencant a 0. Concernant les cles secondaire et tertiaire, nous soustrayons 
un de l'element en cours pour prendre en compte l'element "None (Aucun)". 

La fonction sort ( ) repond a la demande, mais elle manque de fiabilite. Elle suppose que la 
boite de dialogue Sort est implementee de maniere particuliere, avec des zones de liste derou- 
lante et des elements "None". Cela signifie que si nous concevons a nouveau la boite de dialo- 
gue Sort, nous devrions egalement reecrire ce code. Alors que cette approche convient pour 
une boite de dialogue qui est toujours appelee depuis le meme emplacement, elle conduit a un 
veritable cauchemar pour la maintenance si elle est employee a plusieurs endroits. 

Une methode plus fiable consiste a rendre la classe SortDialog plus intelligente en la faisant 
creer un objet SpreadsheetCompare auquel son appelant peut ensuite acceder. Cela simplifie 
significativement MainWindow: : sort ( ) : 
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void MainWindow: :sort() 
{ 

SortDialog dialog(this) ; 

QTableWidgetSelectionRange range = spreadsheet->selectedRange( ) ; 
dialog. setColumnRange( 'A' + range. leftColumn() , 
'A' + range. rightColumnf ) ) ; 

if (dialog. exec () ) 

spreadsheet->perf ormSort (dialog . comparisonObj ect ( ) ) ; 

} 

Cette approche conduit a des composants relativement independants et constitue presque 
toujours le bon choix pour des boites de dialogue qui seront invoquees depuis plusieurs empla- 
cements. 

Une technique plus radicale serait de transmettre un pointeur a l'objet Spreadsheet au 
moment de 1' initialisation de l'objet SortDialog et de permettre a la boite de dialogue 
d'operer directement sur Spreadsheet. SortDialog devient done moins general, parce qu'il 
ne fonctionnera que dans certains types de widgets, mais cela simplifie davantage le code en 
eliminant la fonction SortDialog :: setColumnRange ( ). La fonction MainWin- 
dow: : sort ( ) devient done 

void MainWindow: : sort () 
{ 

SortDialog dialog(this) ; 

dialog . setSpreadsheet (spreadsheet ) ; 

dialog. exec() ; 

} 

Cette approche reproduit la premiere : 1' appelant n'a pas besoin de connaitre la boite de dialogue 
dans les moindres details, mais e'est la boite de dialogue qui doit totalement connaitre les structures 
de donnees fournies par 1' appelant. Cette technique peut etre pratique quand la boite de dialogue 
doit appliquer des changements en direct. Mais comme le code d'appel peu fiable de la premiere 
approche, cette troisieme methode ne fonctionne plus si les structures de donnees changent. 

Certains developpeurs choisissent une approche quant a 1' utilisation des boites de dialogue et 
n'en changent plus. Cela presente l'avantage de favoriser la familiarite et la simplicite, parce 
que toutes leurs boites de dialogue respectent le meme schema, mais ils passent a cote des 
benefices apportes par les autres approches. La meilleure approche consiste a choisir la 
methode au cas par cas. 

Nous allons clore cette section avec la boite de dialogue About. Nous pourrions creer une boite 
de dialogue personnalisee comme pour les boites de dialogue Find ou Go-to-Cell pour presen- 
ter les informations relatives a 1' application, mais vu que la plupart des boites About adoptent 
le meme style, Qt propose une solution plus simple. 

void MainWindow: : about () 
{ 

QMessageBox: :about(this, tr("About Spreadsheet"), 
tr( "<h2>Spreadsheet 1.1</h2>" 
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<p>Copyright © 2006 Software Inc." 
<p>Spreadsheet is a small application that " 
demonstrates QAction, QMainWindow, QMenuBar, " 
QStatusBar, QTableWidget, QToolBar, and many other 
Qt classes. ")) ; 



} 



Vous obtenez la boite About en appelant tout simplement la fonction statique QMessage- 
Box : : about ( ). Cette fonction ressemble beaucoup a QMessageBox : : warning ( ), sauf qu'elle 
emploie l'icone de la fenetre parent au lieu de l'icone standard d'avertissement. 



Figure 3.15 

La boite About 
de Spreadsheet 



[l-l About Spreadsheet 



Spreadsheet 1.1 

Copyright ©2006 Software Inc. 

Spreadsheet is a small application that demonstrates 
QAction, QMainWindow. QMenuBar, QStatusBar, 
QTableWidget, QToolBar, and many other Qt classes. 



OK 



Jusqu'a present, nous avons utilise plusieurs fonctions statiques commodes dans QMessage- 
Box et QFileDialog. Ces fonctions creent une boite de dialogue, l'initialisent et appellent 
exec ( ) . II est egalement possible, meme si c'est moins pratique, de creer un widget QMessa- 
geBox ou QFileDialog comme n'importe quel autre widget et d'appeler explicitement 
exec( ) ou meme show( ). 



Stocker des parametres 

Dans le constructeur MainWindow, nous avons invoque readSettings ( ) arm de charger les 
parametres stockes de 1' application. De meme, dans closeEvent ( ), nous avons appele 
writeSettings ( ) pour sauvegarder les parametres. Ces deux fonctions sont les dernieres 
fonctions membres MainWindow qui doivent etre implementees. 

void MainWindow: :writeSettings() 
{ 

QSettings settings( "Software Inc.", "Spreadsheet"); 

settings. setValue( "geometry" , geometry ( ) ) ; 

settings. setValue ( " recentFiles" , recentFiles) ; 

settings. setValue ( "showGrid" , showGridAction->isChecked( ) ) ; 

settings. setValue ( "autoRecalc" , autoRecalcAction->isChecked( ) ) ; 

} 
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La fonction writeSettings ( ) enregistre la disposition (position et taille) de la fenetre princi- 
pal, la liste des fichiers ouverts recemment et les options Show Grid et Auto-Recalculate. 

Par defaut, QSettings stocke les parametres de l'application a des emplacements specifiques 
a la plate -forme. Sous Windows, il utilise le registre du systeme ; sous Unix, il stocke les 
donnees dans des fichiers texte ; sous Mac OS X, il emploie l'API des preferences de Core 
Foundation. 

Les arguments du constructeur specifient les noms de 1' organisation et de l'application. Ces 
informations sont exploiters d'une facon specifique a la plate-forme pour trouver un emplacement 
aux parametres. 

QSettings stocke les parametres sous forme de paires cle-valeur. La cle est similaire au 
chemin d'acces du systeme de fichiers. Des sous-cles peuvent etre specifiees grace a une 
syntaxe de style chemin d'acces (par exemple, findDialog/matchCase) ou a beginGroup ( ) et 
endGroup() : 

settings. beginGroupf "findDialog" ) ; 

settings. setValue ( "matchCase" , caseCheckBox->isChecked( ) ) ; 
settings.setValue( "searchBackward" , backwardCheckBox->isChecked( ) ) ; 
settings. endGroup( ) ; 

La valeur peut etre de type int, bool, double, QString, QStringList, ou de n'importe quel 
autre type pris en charge par QVa riant, y compris des types personnalises enregistres. 

void MainWindow: :readSettings() 
{ 

QSettings settings( "Software Inc.", "Spreadsheet"); 

QRect rect = settings. value( "geometry" , 

QRect(200, 200, 400, 400) ) .toRect() ; 

move ( rect .topLeft ( ) ) ; 
resize(rect .size( ) ) ; 

recentFiles = settings .value( "recentFiles" ) .toStringListf ) ; 
updateRecentFileActions( ) ; 

bool showGrid = settings. value( "showGrid" , true) .toBool( ) ; 
showGridAction->setChecked(showGrid) ; 

bool autoRecalc = settings. value( "autoRecalc" , true) .toBool( ) ; 
autoRecalcAction->setChecked(autoRecalc) ; 

} 

La fonction readSettings ( ) charge les parametres qui etaient sauvegardes par writeSet- 
tings ( ) . Le deuxieme argument de la fonction value ( ) indique une valeur par defaut, dans 
le cas ou aucun parametre n'est disponible. Les valeurs par defaut sont utilisees la premiere 
fois que l'application est executee. Etant donne qu'aucun second argument n'est indique pour 
la liste des fichiers recents, il sera defini en liste vide a la premiere execution. 
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Qt propose une fonction QWidget : : setGeometry ( ) pour completer QWidget :: geo- 
metry ( ) , mais elle ne fonctionne pas toujours comme prevu sous XI 1 en raison des limites de 
la plupart des gestionnaires de fenetre. C'est pour cette raison que nous utilisons plutot move ( ) 
et resize (). (Voir http://doc.trolltech.eom/4.l/geometry.html pour une explication plus 
detaillee.) 

Nous avons opte pour une organisation dans MainWindow parmi de nombreuses approches 
possibles, avec tout le code associe a QSettings dans readSettings ( ) et writeSet- 
tings ( ) . Un objet QSettings peut etre cree pour identifier ou modifier un parametre pendant 
1' execution de 1' application et n'importe oil dans le code. 

Nous avons desormais implements MainWindow dans Spreadsheet. Dans les sections suivan- 
tes, nous verrons comment 1' application Spreadsheet peut etre modifiee de maniere a gerer 
plusieurs documents, et comment implementer une page d'accueil. Nous completerons ses 
fonctionnalites, notamment avec la gestion des formules et le tri, dans le prochain chapitre. 

Documents multiples 

Nous sommes desormais prets a coder la fonction main ( ) de 1' application Spreadsheet : 

#include <QApplication> 

#include "mainwindow.h" 

int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
MainWindow mainWin; 
mainWin.show() ; 
return app.exec() ; 

} 

Cette fonction main ( ) est legerement differente de celles que nous avons ecrites jusque la : 
nous avons cree l'instance MainWindow comme une variable sur la pile au lieu d'utiliser new. 
L' instance MainWindow est ensuite automatiquement detruite quand la fonction se termine. 

Avec la fonction main() presentee ci-dessus, l'application Spreadsheet propose une seule 
fenetre principale et ne peut gerer qu'un document a la fois. Si vous voulez modifier plusieurs 
documents en meme temps, vous pourriez demarrer plusieurs instances de l'application 
Spreadsheet. Mais ce n'est pas aussi pratique pour les utilisateurs que d'avoir une seule 
instance de l'application proposant plusieurs fenetres principales, tout comme une instance 
d'un navigate ur Web peut fournir plusieurs fenetres de navigate ur simultanement. 

Nous modifierons l'application Spreadsheet de sorte qu'elle puisse gerer plusieurs documents. 
Nous avons tout d'abord besoin d'un menu File legerement different : 

• File > New cree une nouvelle fenetre principale avec un document vide, au lieu de reutiliser 
la fenetre principale existante. 
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• File > Close ferme la fenetre principale active. 

• File > Exit ferme toutes les fenetres. 

Dans la version originale du menu File, il n'y avait pas d'option Close parce qu'elle aurait eu 
la meme fonction qu'Exit. 

Figure 3.16 r^r\ 
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Voici la nouvelle fonction main ( ) : 

int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
MainWindow *mainWin = new MainWindow; 
mainWin->show( ) ; 
return app.exec() ; 

} 

Avec plusieurs fenetres, il est maintenant interessant de creer MainWindow avec new, puisque 
nous avons ensuite la possibilite d'executer delete sur une fenetre principale quand nous 
avons fini afin de liberer la memoire. 

Voici le nouveau slot MainWindow : : newFile ( ) : 

void MainWindow: : newFile( ) 
{ 

MainWindow *mainWin = new MainWindow; 
mainWin->show() ; 

} 

Nous creons simplement une nouvelle instance de MainWindow. Cela peut sembler stupide de 
ne pas conserver un pointeur vers la nouvelle fenetre, mais ce n'est pas un probleme etant 
donne que Qt assure le suivi de toutes les fenetres pour nous. 

Voici les actions pour Close et Exit : 

void MainWindow: :createActions() 
{ 

closeAction = new QAction(tr( "&Close" ) , this); 
closeAction->setShortcut(tr( "Ctrl+W" ) ) ; 
closeAction->setStatusTip(tr( "Close this window")); 
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connect(closeAction, SIGNAL(triggered( ) ) , this, SLOT(close() ) ) ; 

exitAction = new QAction(tr("E&xit") , this); 
exitAction->setShortcut (tr ( "Ctrl+Q" ) ) ; 
exitAction->setStatusTip(tr( "Exit the application")); 
connectfexitAction, SIGNAL(triggered()) , 
qApp, SLOT(closeAllWindows() ) ) ; 

} 

Le slot QApplication : : closeAHWindows ( ) ferme toutes les fenetres de 1' application, a 
moins qu'une d'elles ne refuse l'evenement close. C'est exactement le comportement dont 
nous avons besoin ici. Nous n'avons pas a nous soucier des modifications non sauvegardees 
parce que MainWindow: : closeEvent ( ) s'en charge des qu'une fenetre est fermee. 

II semble que notre application est maintenant capable de gerer plusieurs fenetres. Malheureu- 
sement, il reste un probleme masque : si l'utilisateur continue a creer et fermer des fenetres 
principales, la machine pourrait eventuellement manquer de memoire. C'est parce que nous 
continuons a creer des widgets MainWindow dans newFile ( ) , sans jamais les effacer. Quand 
l'utilisateur ferme une fenetre principale, le comportement par defaut consiste a la masquer, 
elle reste done en memoire. Vous risquez done de rencontrer des problemes si le nombre de 
fenetres principales est important. 

La solution est de definir l'attribut Qt : : WA_DeleteOnClose dans le constructeur : 

MainWindow: :MainWindow( ) 
{ 

setAttribute(Qt: :WA_DeleteOnClose) ; 

} 

II ordonne a Qt de supprimer la fenetre lorsqu'elle est fermee. L'attribut Qt: :WA_Delete- 
OnClose est l'un des nombreux indicateurs qui peuvent etre definis sur un QWidget pour 
influencer son comportement. 

La fuite de memoire n'est pas le seul probleme rencontre. La conception de notre application 
d'origine supposait que nous aurions une seule fenetre principale. Dans le cas de plusieurs 
fenetres, chaque fenetre principale possede sa propre liste de fichiers ouverts recemment et ses 
propres options. II est evident que la liste des fichiers ouverts recemment doit etre globale a 
toute 1' application. En fait, il suffit de declarer la variable recentFiles comme statique pour 
qu'une seule instance soit geree par 1' application. Mais nous devons ensuite garantir que tous 
les appels de updateRecentFileActions ( ) destines a mettre a jour le menu File concernent 
bien toutes les fenetres principales. Voici le code pour obtenir ce resultat : 

foreach (QWidget *win, QApplication: :topLevelWidgets()) { 

if (MainWindow *mainWin = qobject_cast<MainWindow *>(win)) 
mainWin->updateRecentFileActions ( ) ; 

} 
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Ce code s'appuie sur la construction f oreach de Qt (expliquee au Chapitre 11) pour parcourir 
toutes les fenetres de l'application et appelle updateRecentFileActions ( ) sur tous les 
widgets de type MainWindow. Un code similaire peut etre employe pour synchroniser les options 
Show Grid et Auto-Recalculate ou pour s'assurer que le meme fichier n'est pas charge 
deux fois. 

Les applications qui proposent un document par fenetre principale sont appelees des applica- 
tions SDI (single document interface). II existe une alternative courante sous Windows : MDI 
(multiple document interface), oil l'application comporte une seule fenetre principale qui gere 
plusieurs fenetres de document dans sa zone d'affichage centrale. Qt peut etre utilise pour creer 
des applications SDI et MDI sur toutes les plates-formes prises en charge. La Figure 3.17 montre 
les deux versions de l'application Spreadsheet. MDI est aborde au Chapitre 6. 



Figure 3.17 

SDI versus MDI 




Pages d'accueil 

De nombreuses applications affichent une page d'accueil au demarrage. Certains developpeurs 
se servent de cette page pour dissimuler un demarrage lent, alors que d'autres l'exploitent pour 
leurs services marketing. La classe QSplashScreen facilite l'ajout d'une page d'accueil aux 
applications Qt. 

Cette classe affiche une image avant 1' apparition de la fenetre principale. Elle peut aussi ecrire 
des messages sur l'image pour informer l'utilisateur de la progression du processus d'initiali- 
sation de l'application. En general, le code de la page d'accueil se situe dans main(), avant 
l'appel de QApplication : : exec( ). 

Le code suivant est un exemple de fonction main ( ) qui utilise QSplashScreen pour presenter 
une page d'accueil dans une application qui charge des modules et etablit des connexions 
reseau au demarrage. 

int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
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QSplashScreen *splash = new QSplashScreen; 
splash->setPixmap(QPixmap( " : /images/ splash. png" ) ) ; 
splash->show( ) ; 

Qt : :Alignment topRight = Qt : :AlignRight | Qt : :AlignTop; 

splash->showMessage(QObject: :tn( "Setting up the main window..."), 
topRight, Qt::white); 

MainWindow mainWin; 

splash->showMessage(QObject: :tr("Loading modules. .."), 
topRight, Qt::white); 

loadModules() ; 

splash->showMessage(QObject : :tr( "Establishing connections. . . " ) , 

topRight, Qt: :white) ; 
establishConnections() ; 

mainWin.show() ; 
splash->finish(&mainWin) ; 
delete splash; 

return app.execf) ; 



} 



Figure 3.18 
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Nous avons desormais termine l'etude de l'interface utilisateur de l'application Spreadsheet. 
Dans le prochain chapitre, vous completerez l'application en implementant la fonctionnalite 
principale du tableur. 
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Implementer 

la fonctionnalite d' application 



Dans les deux precedents chapitres, nous vous avons explique comment creer 1' interface 
utilisateur de 1' application Spreadsheet. Dans ce chapitre, nous terminerons le 
programme en codant sa fonctionnalite sous-jacente. Nous verrons entre autres 
comment charger et sauvegarder des fichiers, stocker des donnees en memoire, imple- 
menter des operations du presse-papiers et ajouter une prise en charge des formules de 
la feuille de calcul a QTableWidget. 




Au sommaire de ce chapitre 

t/ Le widget central 

✓ Derivation de QTable 
✓Widget 

✓ Chargement et sauvegarde 

✓ Implementer le menu Edit 

i/ Implementer les autres menus 
«/ Derivation de QTableWidgetltem 
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Le widget central 

La zone centrale d'un QMainWindow peut etre occupee par n'importe quel type de widget. 
Voici quelques possibilites : 

1 . Utiliser un widget Qt standard. 

Un widget standard comme QTableWidget ou QTextEdit peut etre employe comme 
widget central. Dans ce cas, la fonctionnalite de 1' application, telle que le chargement et la 
sauvegarde des fichiers, doit etre implemented quelque part (par exemple dans une sous- 
classe QMainWindow). 

2. Utiliser un widget personnalise. 

Des applications specialisees ont souvent besoin d'afficher des donnees dans un widget 
personnalise. Par exemple, un programme d'editeur d'icones aurait un widget IconEditor 
comme widget central. Le Chapitre 5 vous explique comment ecrire des widgets person- 
nalises dans Qt. 

3. Utiliser un QWidget ordinaire avec un gestionnaire de disposition. 

II peut arriver que la zone centrale de 1' application soit occupee par plusieurs widgets. 
C'est possible grace a l'utilisation d'un QWidget comme parent de tous les autres widgets 
et de gestionnaires de disposition pour dimensionner et positionner les widgets enfants. 

4. Utiliser un separateur. 

II existe un autre moyen d'utiliser plusieurs widgets ensembles : un QSplitter. QSplit- 
ter dispose ses widgets enfants horizontalement ou verticalement et le separateur offre la 
possibilite a l'utilisateur d'agir sur cette disposition. Les separateurs peuvent contenir tout 
type de widgets, y compris d' autres separateurs. 

5. Utiliser un espace de travail MDI. 

Si l'application utilise MDI, la zone centrale est occupee par un widget QWorkspace et 
chaque fenetre MDI est un enfant de ce widget. 

Les dispositions, les separateurs et les espaces de travail MDI peuvent etre combines a des 
widgets Qt standards ou personnalises. Le Chapitre 6 traite de ces classes tres en detail. 

Concernant l'application Spreadsheet, une sous-classe QTableWidget sert de widget central. 
La classe QTableWidget propose deja certaines fonctionnalites de feuille de calcul dont nous 
avons besoin, mais elle ne prend pas en charge les operations du presse-papiers et ne comprend 
pas les formules comme "=Al+A2+A3".Nous implementerons cette fonction manquante dans 
la classe Spreadsheet. 
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Derivation de QTableWidget 

La classe Spreadsheet herite de QTableWidget. Un QTableWidget est une grille qui repre- 
sente un tableau en deux dimensions. II affiche n'importe quelle cellule que l'utilisateur fait 
defiler, dans ses dimensions specifiees. Quand l'utilisateur saisit du texte dans une cellule vide, 
QTableWidget cree automatiquement un QTableWidget Item pour stacker le texte. 

Implementons Spreadsheet en commencant par le fichier d'en-tete : 

#ifndef SPREADSHEET^ 
#define SPREADSHEET^ 

#include <QTableWidget> 

class Cell; 

class SpreadsheetCompare; 
L'en-tete commence par les declarations prealables des classes Cell et SpreadsheetCompare. 

Figure 4.1 QObject 

Arbres d'heritage pour I 
Spreadsheet et Cell QWidget 

QTableWidget QTableWidgetltem 

I I 
Spreadsheet Cell 

Les attributs d'une cellule QTableWidget, tels que son texte et son alignement, sont conserves 
dans un QTableWidgetltem. Contrairement a QTableWidget, QTableWidgetltem n'est pas 
une classe de widget ; c'est une classe de donnees. La classe Cell herite de QTableWidget- 
ltem. Elle est detaillee pendant la presentation de son implementation dans la derniere section 
de ce chapitre. 

class Spreadsheet : public QTableWidget 
{ 

Q_0BJECT 
public: 

Spreadsheet (QWidget *parent = 0); 

bool autoRecalculate( ) const { return autoRecalc; } 
QString currentLocation( ) const; 
QString currentFormula( ) const; 
QTableWidgetSelectionRange selectedRangef) const; 
void clear ( ) ; 

bool readFilefconst QString &fileName); 
bool writeFile(const QString &fileName); 
void sort(const SpreadsheetCompare &compare); 
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La fonction autoRecalculate() est implementee en mode inline (en ligne) parce qu'elle 
indique simplement si le recalcul automatique est active ou non. 

Dans le Chapitre 3, nous nous sommes bases sur des fonctions publiques dans Spreadsheet lors- 
que nous avons implements MainWindow. Par exemple, nous avons appele clear ( ) depuis Main- 
Window : : newFile ( ) pour reinitialiser la feuille de calcul. Nous avons aussi utilise certaines 
fonctions heritees de QTableWidget, notamment setCurrentCell ( ) et setShowGrid ( ). 

public slots: 
void cut() ; 
void copy( ) ; 
void paste() ; 
void del( ) ; 

void selectCurrentRow( ) ; 

void selectCurrentColumn( ) ; 

void recalculate() ; 

void setAutoRecalculate(bool recalc); 

void findNext(const QString &str, Qt : :CaseSensitivity cs); 
void findPrevious (const QString &str, Qt : :CaseSensitivity cs); 

signals: 

void modified ( ) ; 

Spreadsheet propose plusieurs slots implementant des actions depuis les menus Edit, Tools 
et Options, de meme qu'un signal, modified ( ) , pour annoncer tout changement. 

private slots: 

void somethingChangedO ; 

Nous definissons un slot prive exploite en interne par la classe Spreadsheet. 

private: 

enum { MagicNumber = 0X7F51C883, RowCount = 999, ColumnCount = 26 }; 

Cell *cell(int row, int column) const; 

QString text (int row, int column) const; 

QString formula(int row, int column) const; 

void setFormulafint row, int column, const QString &formula) ; 

bool autoRecalc; 

}; 

Dans la section privee de la classe, nous declarons trois constantes, quatre fonctions et une 
variable. 

class SpreadsheetCompare 
{ 

public: 

bool operator( ) (const QStringList &row1 , 

const QStringList &row2) const; 

enum { KeyCount = 3 }; 
int keys[KeyCount] ; 
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bool ascending [KeyCount] ; 

}; 

#endif 

Le fichier d'en-tete se termine par la definition de la classe SpreadsheetCompare. Nous 
reviendrons sur ce point lorsque nous etudierons Spreadsheet : : sort ( ). 

Nous allons desormais passer en revue l' implementation : 

#include <QtGui> 

#include "cell.h" 
#include "spreadsheet. h" 

Spreadsheet: :Spreadsheet(QWidget *parent) 
: QTableWidget(parent) 

{ 

autoRecalc = true; 

setItemPrototype(new Cell); 
setSelectionMode(ContiguousSelection) ; 

connect(this, SIGNAL(itemChanged(QTableWidgetItem *)), 
this, SLOT(somethingChanged( ) ) ) ; 

clear( ) ; 

} 

Normalement, quand l'utilisateur saisit du texte dans une cellule vide, QTableWidget cree 
automatiquement un QTableWidget Item pour contenir le texte. Dans notre feuille de calcul, 
nous voulons plutot creer des elements Cell. Pour y parvenir, nous appelons setltemProto- 
type( ) dans le constructeur. En interne, QTableWidget copie 1' element transmis comme un 
prototype a chaque fois qu'un nouvel element est requis. 

Toujours dans le constructeur, nous definissons le mode de selection en QAbstract- 
ItemView: : ContiguousSelection pour autoriser une seule selection rectangulaire. Nous 
connectons le signal itemChanged ( ) du widget de la table au slot prive somethingChan- 
ged ( ) ; lorsque l'utilisateur modifie une cellule, nous sommes done stirs que le slot some- 
thingChanged ( ) est appele. Enfin, nous invoquons clear ( ) pour redimensionner la table et 
configurer les en-tetes de colonne. 

void Spreadsheet: :clear() 
{ 

setRowCount(O) ; 
setColumnCount(0) ; 
setRowCount(RowCount) ; 
setColumnCount(ColumnCount) ; 

for (int i = 0; i < ColumnCount; ++i) { 

QTableWidgetltem *item = new QTableWidgetltem; 
item->setText(QString(QChar( 'A' + i))); 
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setHorizontalHeaderltemfi, item) ; 

} 



setCurrentCell(0, 0); 

} 

La fonction clear () est appelee depuis le constructeur Spreadsheet pour initialiser la 
feuille de calcul. Elle est aussi invoquee a partir de MainWindow: : newFile ( ). 

Nous aurions pu utiliser QTableWidget : : clear ( ) pour effacer tous les elements et toutes les 
selections, mais les en-tetes auraient conserve leurs tailles actuelles. Au lieu de cela, nous redi- 
mensionnons la table en 0 x 0. Toute la feuille de calcul est done effacee, y compris les en- 
tetes. Nous redimensionnons ensuite la table en ColumnCount _ RowCount (26 _ 999) et nous 
alimentons l'en-tete horizontal avec des QTableWidget Item qui contiennent les noms de 
colonne "A", "B", "Z".Nous ne sommes pas obliges de definir les intitules des en-tetes 
verticaux, parce qu'ils presentent par defaut les valeurs suivantes : "1", "2",..., "999". 
Pour terminer, nous placons le curseur au niveau de la cellule Al. 

Figure 4.2 

Les widgets 
qui constituent 
QTableWidget 





horizontal Header 0 


CO 

O 

b 

CO 
n5 
_o 


CD 

~o 

CC 
CD 
X 
cC 
o 
























^ 


iewport() 














"tr 

CD 
> 












> 
















horizontalScrollBar() 





Un QTableWidget se compose de plusieurs widgets enfants (voir Figure 4.2). Un QHeader- 
View horizontal est positionne en haut, un QHeaderView vertical a gauche et deux QScroll- 
Bar terminent cette composition. La zone au centre est occupee par un widget special appele 
viewport, sur lequel notre QTableWidget dessine les cellules. Les divers widgets enfants 
sont accessibles par le biais de fonctions heritees de QTableViewet QAbstractScrollArea 
(voir Figure 4.2). QAbstractScrollAreafournit un viewport equipe de deux barres de defile- 
ment, que vous pouvez activer ou desactiver. Sa sous-classe QScrollArea est abordee au 
Chapitre 6. 



Stocker des donnees en tant qu'elements 

Dans ('application Spreadsheet, chaque cellule non vide est stockee en memoire sous forme 
d'objet QTableWidget Item individuel. Stocker des donnees en tant qu'elements est une appro- 
che egalement utilisee par QListWidget et QTreeWidget, qui agissent sur QListWidgetltem et 
QTreeWidgetltem. 
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Les classes d'elements de Qt peuvent etre directement employees comme des conteneurs de 
donnees. Par exemple, un QTableWidgetltem stocke par definition quelques attributs, y compris 
une chaTne, une police, une couleur et une icone, ainsi qu'un pointeur vers QTableWidget. 
Les elements ont aussi la possibility de contenir des donnees (QVariant), dont des types 
personnalises enregistres, et en derivant la classe d'elements, nous pouvons proposer des fonction- 
nalites supplementaires. 

D'autres kits d'outils fournissent un pointeur void dans leurs classes d'elements pour conserver 
des donnees personnalisees. Dans Qt, I'approche la plus naturelle consiste a utiliser setData() 
avec un QVariant, mais si un pointeur void est necessaire, vous deriverez simplement une 
classe d'elements et vous ajouterez une variable membre pointeur void. 

Quand la gestion des donnees devient plus exigeante, comme dans le cas de jeux de donnees 
de grande taille, d'elements de donnees complexes, d'une integration de base de donnees et de 
vues multiples de donnees, Qt propose un ensemble de classes modele/vue qui separent les 
donnees de leur representation visuelle. Ces themes sont traites au Chapitre 10. 



Cell *Spreadsheet: :cell(int row, int column) const 
{ 

return static_cast<Cell *>( item (row, column)); 

} 

La fonction privee cell( ) retourne l'objet Cell pour une ligne et une colonne donnees. Elle 
est presque identique a QTableWidget : : item( ), sauf qu'elle renvoie un pointeur de Cell au 
lieu d'un pointeur de QTableWidgetltem. 

QString Spreadsheet: :text(int row, int column) const 
{ 

Cell *c = cell(row, column); 
if (c) { 

return c->text() ; 
} else { 

return ""; 

} 

} 

La fonction privee text ( ) retourne le texte d'une cellule particuliere. Si cell ( ) retourne un 
pointeur nul, la cellule est vide, une chaine vide est done renvoyee. 

QString Spreadsheet : : formula (int row, int column) const 
{ 

Cell *c = cellfrow, column); 
if (c) { 

return c->formula( ) ; 
} else { 

return ""; 

} 

} 
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La fonction formula ( ) retourne la formule de la cellule. Dans la plupart des cas, la formule et le 
texte sont identiques ; par exemple, la formule "Hello" determine la chaine "Hello", done si l'utili- 
sateur tape "Hello" dans une cellule et appuie sur Entree, cette cellule affichera le texte "Hello". 

Mais il y a quelques exceptions : 

• Si la formule est un nombre, elle est interpreted en tant que tel. Par exemple, la formule 
"1,50" interprete la valeur en type double 1,5, qui est affiche sous la forme "1,5" justifie a 
droite dans la feuille de calcul. 

• Si la formule commence par une apostrophe, le reste de la formule est considere comme du 
texte. Par exemple, la formule " '12345" interprete cette valeur comme la chaine "12345." 

• Si la formule commence par un signe egal (=), elle est consideree comme une formule 
arithmetique. Par exemple, si la cellule Al contient "12" et si la cellule A2 comporte le 
chiffre "6", la formule "=A1+A2" est egale a 18. 

La tache qui consiste a convertir une formule en valeur est accomplie par la classe Cell. Pour 
l'instant, l'important est de se souvenir que le texte affiche dans la cellule est le resultat de 
revaluation d'une formule et pas la formule en elle-meme. 

void Spreadsheet: :setFormula(int row, int column, 

const QString &formula) 

{ 

Cell *c = cell(row, column); 
if (!c) { 

c = new Cell; 

setltemfrow, column, c); 

} 

c->setFormula(f ormula) ; 

} 

La fonction privee setFormula( ) definit la formule d'une cellule donnee. Si la cellule 
contient deja un objet Cell, nous le reutilisons. Sinon, nous creons un nouvel objet Cell et nous 
appelons QTableWidget : : setltem( ) pour l'inserer dans la table. Pour terminer, nous invo- 
quons la propre fonction setFormula ( ) de la cellule, pour actualiser cette derniere si elle est 
affichee a l'ecran. Nous n'avons pas a nous soucier de supprimer l'objet Cell par la suite ; 
QTableWidget prend en charge la cellule et la supprimera automatiquement au moment voulu. 

QString Spreadsheet: :currentLocation( ) const 
{ 

return QChar('A' + currentColumnf)) 

+ QString: :number(currentRow() +1); 

} 

La fonction currentLocation ( ) retourne l'emplacement de la cellule actuelle dans le format 
habituel de la feuille de calcul, soit la lettre de la colonne suivie du numero de la ligne. 
MainWindow: : updateStatusBar ( ) l'utilise pour afficher l'emplacement dans labarre d'etat. 

QString Spreadsheet: :currentFormula() const 
{ 

return f ormula(currentRow( ) , currentColumnf)); 

} 
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La fonction currentFormula( ) retourne la formule de la cellule en cours. Elle est invoquee a 
partir de MainWindow: : updateStatusBar ( ). 

void Spreadsheet : : somethingChanged ( ) 
{ 

if (autoRecalc) 

recalculate) ) ; 
emit modified () ; 

} 

Le slot prive somethingChanged ( ) recalcule l'ensemble de la feuille de calcul si l'option de 
"recalcul automatique" est activee. II emet egalement le signal modified ( ) . 



Chargement et sauvegarde 

Nous allons desormais implementer le chargement et la sauvegarde des fichiers Spreadsheet 
grace a un format binaire personnalise. Pour ce faire, nous emploierons QFile et QDataStream 
qui, ensemble, fournissent des entrees/sorties binaires independantes de la plate-forme. 

Nous commencons par ecrire un fichier Spreadsheet : 

bool Spreadsheet: :writeFile(const QString &fileName) 
{ 

QFile f ile(f ileName) ; 

if ( !file.open(QIODevice: :WriteOnly) ) { 

QMessageBox: :warning(this, tr( "Spreadsheet" ) , 

tr( "Cannot write file %1:\n%2.") 

.arg(file.fileName()) 

. arg(f ile.errorStringf ) ) ) ; 

return false; 

} 

QDataStream out(&file); 

out. setVersion (QDataStream: :Qt_4_1 ) ; 

out « quint32(MagicNumber) ; 

QApplication: :setOverrideCursor(Qt: :WaitCursor) ; 
for (int row = 0; row < RowCount; ++row) { 

for (int column = 0; column < ColumnCount; ++column) { 
QString str = formulafrow, column); 
if ( !str.isEmpty( ) ) 

out « quint16(row) « quint16(column) « str; 

} 

} 

QApplication: : restoreOverrideCursor( ) ; 
return true; 

} 

La fonction writeFile() est appelee depuis MainWindow: : saveFile ( ) pour ecrire le 
fichier sur le disque. Elle retourne true en cas de succes et false en cas d'erreur. 
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Nous creons un objet QFile avec un nom de fichier donne et nous invoquons open ( ) pour 
ouvrir le fichier en ecriture. Nous creons aussi un objet QDataStream qui agit sur le QFile et 
s'en sert pour ecrire les donnees. 

Juste avant d' ecrire les donnees, nous changeons le pointeur de 1' application en pointeur 
d'attente standard (generalement un sablier) et nous restaurons le pointeur normal lorsque 
toutes les donnees ont ete ecrites. A la fin de la fonction, le fichier est ferme automatiquement 
par le destructeur de QFile. 

QDataStream prend en charge les types C++ de base, de meme que plusieurs types de Qt. 
La syntaxe est concue selon les classes <iostream> du langage C++ Standard. Par exemple, 

out « x « y « z; 

ecrit les variables x, y et z dans un flux, et 

in » x » y » z; 

les lit depuis un flux. Etant donne que les types C++ de base char, short, int, long et long 
long peuvent presenter des tailles differentes selon les plates-formes, il est plus sur de conver- 
tir ces valeurs en qint8, quint8, qint16, quint16, qint32, quint32, qint64 ou 
quint64 ; vous avez ainsi la garantie de travailler avec un type de la taille annoncee (en bits). 

Le format de fichier de 1' application Spreadsheet est assez simple (voir Figure 4.3). Un fichier 
Spreadsheet commence par un numero sur 32 bits qui identifie le format de fichier (Magic- 
Number, defini par 0X7F51C883 dans spreadsheet . h, un chiffre aleatoire). Ce numero est 
suivi d'une serie de blocs, chacun d'eux contenant la ligne, la colonne et la formule d'une 
seule cellule. Pour economiser de l'espace, nous n'ecrivons pas de cellules vides. 

Figure 4.3 
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La representation binaire precise des types de donnees est determined par QDataStream. Par 
exemple, un type quint16 est stocke sous forme de deux octets en ordre big-endian, et un 
QString se compose de la longueur de la chaine suivie des caracteres Unicode. 

La representation binaire des types Qt a largement evolue depuis Qt 1.0. II est fort probable 
qu'elle continue son developpement dans les futures versions de Qt pour suivre revolution des 
types existants et pour tenir compte des nouveaux types Qt. Par defaut, QDataSt ream utilise la 
version la plus recente du format binaire (version 7 dans Qt 4.1), mais il peut etre configure de 
maniere a lire des versions anterieures. Pour eviter tout probleme de compatibilite si T applica- 
tion est recompilee par la suite avec une nouvelle version de Qt, nous demandons explicitement a 
QDataStream d'employer la version 7 quelle que soit la version de Qt utilisee pour la compi- 
lation. (QDataSt ream : : Qt_4_1 est une constante pratique qui vaut 7.) 

QDataStream est tres polyvalent. II peut etre employe sur QFile, mais aussi sur QBuffer, 
QProcess, QTcpSocket ou QUdpSocket. Qt propose egalement une classe QTextStream qui 
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peut etre utilisee a la place de QDataStream pour lire et ecrire des fichiers texte. Le Chapi- 
tre 12 se penche en detail sur ces classes et decrit les diverses approches consistant a gerer les 
differentes versions de QDataStream. 

bool Spreadsheet: :readFile(const QString &fileName) 
{ 

QFile file(fileName) ; 

if ( !file.open(QIODevice: :ReadOnly) ) { 

QMessageBox: : warning (this, tr( "Spreadsheet" ) , 

tr( "Cannot read file %1:\n%2.") 

.arg(file.fileName()) 

. arg (file. errorSt ring () ) ) ; 

return false; 

} 

QDataStream in(&file); 

in. setVersion (QDataStream: :Qt_4_1 ) ; 

quint32 magic; 
in » magic; 

if (magic != MagicNumber) { 

QMessageBox: : warning (this, tr( "Spreadsheet" ) , 

tr("The file is not a Spreadsheet file.")); 

return false; 

} 

clear( ) ; 

quint16 row; 
quint16 column; 
QString str; 

QApplication: : setOverrideCursor(Qt : :WaitCursor) ; 
while (!in.atEnd()) { 

in » row » column » str; 

setFormula(row, column, str); 

} 

QApplication: : restoreOverrideCursor( ) ; 
return true; 

} 

La fonction readFile ( ) ressemble beaucoup a writeFile ( ) . Nous utilisons QFile pour lire 
le fichier, mais cette fois-ci avec QIODevice: : Readonly et pas QIODevice: :WriteOnly. 
Puis nous definissons la version de QDataStream en 7. Le format de lecture doit toujours etre 
le meme que celui de l'ecriture. 

Si le fichier debute par le nombre magique approprie, nous appelons clear () pour vider 
toutes les cellules de la feuille de calcul et nous lisons les donnees de la cellule. Vu que le 
fichier ne contient que des donnees pour des cellules non vides, et qu'il est tres improbable que 
chaque cellule de la feuille de calcul soit definie, nous devons nous assurer que toutes les cellules 
sont effacees avant la lecture. 
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Implementer le menu Edit 



Nous sommes desormais pret a implementer les slots qui correspondent au menu Edit de 
1' application. Ce menu est presente en Figure 4.4. 

void Spreadsheet: : cut () 
{ 

copy(); 
del(); 

} 

Le slot cut ( ) correspond a Edit > Cut. L' implementation est simple parce que Cut est equivalent 
a Copy suivi de Delete. 



Figure 4.4 
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void Spreadsheet: :copy() 
{ 

QTableWidgetSelectionRange range = selectedRange( ) ; 
QString str; 

for (int i = 0; i < range. rowCount( ) ; ++i) { 
if (i > 0) 

str += "\n" ; 

for (int j = 0; i < range. columnCount() ; ++j) { 
if (j > 0) 

str += "\t"; 

str += formula(range.topRow() + i, range. leftColumn() + j); 

} 

} 

QApplication: : clipboard ()->setText (str) ; 

} 

Le slot copy ( ) correspond a Edit > Copy. II parcourt la selection actuelle (qui est simplement 
la cellule en cours s'il n'y a pas de selection explicite). La formule de chaque cellule selection- 
nee est ajoutee a QSt r ing, avec des lignes separees par des sauts de ligne et des colonnes separees 
par des tabulations. 

Le presse-papiers est disponible dans Qt par le biais de la fonction statique QApplica- 
tion : : clipboard ( ). En appelant QClipboard : : setText ( ), le texte est disponible dans le 
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presse-papiers, a la fois pour cette application et pour d'autres qui prennent en charge le texte 
brut (voir Figure 4.5). Notre format, base sur les tabulations et les sauts de lignes en tant que 
separateurs, est compris par une multitude d' applications, dont Microsoft Excel. 



Figure 4.5 

Copier une selection 
dans le presse-papiers 

















Blue 




Cyan 


Magenta 


Yellow 



"Red\tGreen\tBlue\nCyan\tMagenta\tYellow" 



La fonction QTableWidget : : selectedRanges ( ) retourne une liste de plages de selection. 
Nous savons qu'il ne peut pas y en avoir plus d'une, parce que nous avons defini le mode de 
selection en QAbstractltemView: : ContiguousSelection dans le constructeur. Par souci 
de commodite, nous configurons une fonction selectedRange() qui retourne la plage de 
selection : 

QTableWidgetSelectionRange Spreadsheet: :selectedRange() const 
{ 

QList<QTableWidgetSelectionRange> ranges = selectedRanges () ; 
if ( ranges. isEmptyO ) 

return QTableWidgetSelectionRange ( ) ; 
return ranges. first)) ; 

} 

S'il n'y a qu'une selection, nous retournons simplement la premiere (et unique). Vous ne 
devriez jamais vous trouver dans le cas oil il n'y a aucune selection, etant donne que le mode 
ContiguousSelection considere la cellule en cours comme selectionnee. Toutefois pour 
prevenir tout bogue dans notre programme, nous gerons ce cas de figure. 

void Spreadsheet: :paste() 
{ 

QTableWidgetSelectionRange range = selectedRange( ) ; 

QString str = QApplication: :clipboard()->text() ; 

QStringList rows = str.splitf 1 \n' ) ; 

int numRows = rows. count ( ) ; 

int numColumns = rows. first() .count) 1 \t' ) + 1; 

if ( range. rowCountf) * range. columnCountf) != 1 
&& ( range. rowCount() != numRows 

|| range. columnCountO != numColumns)) { 
QMessageBox: :information(this, tr( "Spreadsheet" ) , 

tr("The information cannot be pasted because the copy " 
"and paste areas aren't the same size.")); 

return; 

} 

for (int i = 0; i < numRows; ++i) { 
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QStringList columns = rows[i] . split ( ' \t' ) ; 
for (int j = 0; j < numColumns; ++j) { 

int row = range. topRow() + i; 

int column = range. leftColumn ( ) + j; 

if (row < RowCount && column < ColumnCount) 
setFormula(row, column, columns!]]); 

} 

} 

somethingChangedO ; 



} 



Le slot paste ( ) correspond a Edit > Paste. Nous recuperons le texte dans le presse-papiers et 
nous appelons la fonction statique QString : : split ( ) pour adapter la chaine au QStringList. 
Chaque ligne devient une chaine dans la liste. 

Nous determinons ensuite la dimension de la zone de copie. Le nombre de lignes correspond 
au nombre de chaines dans QStringList ; le nombre de colonnes est le nombre de tabula- 
tions a la premiere ligne, plus 1. Si une seule cellule est selectionnee, nous nous servons de 
cette cellule comme coin superieur gauche de la zone de collage ; sinon, nous utilisons la 
selection actuelle comme zone de collage. 

Pour effectuer le collage, nous parcourons les lignes et nous les divisons en cellules grace a 
QString : : split ( ), mais cette fois-ci avec une tabulation comme separateur. La Figure 4.6 
illustre ces etapes. 
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void Spreadsheet : :del( ) 
{ 

foreach (QTableWidgetltem *item, selectedltems( ) ) 
delete item; 

} 

Le slot del ( ) correspond a Edit > Delete. II suffit d'utiliser delete sur chaque objet Cell de 
la selection pour effacer les cellules. QTableWidget remarque quand ses QTableWidgetltem 
sont supprimes et se redessine automatiquement si l'un des elements etait visible. Si nous invo- 
quons cell ( ) avec l'emplacement d'une cellule supprimee, il renverra un pointeur nul. 
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void Spreadsheet: :selectCurrentRow() 
{ 

selectRow(currentRow( ) ) ; 

} 

void Spreadsheet: :selectCurrentColumn() 
{ 

selectColumn(currentColumn()) ; 

} 

Les fonctions selectCurrentRow( ) et selectCurrentColumn ( ) correspondent aux 
options Edit > Select > Row et Edit > Select > Column. Les implementations reposent sur les 
fonctions selectRow() et selectColumn ( ) de QTableWidget. Nous n'avons pas a imple- 
menter la fonctionnalite correspondant a Edit > Select > All, etant donne qu'elle est proposee 
par la fonction heritee QAbstractltemView: :selectAll() de QTableWidget. 

void Spreadsheet: :findNext(const QString &str, Qt: :CaseSensitivity cs) 
{ 

int row = currentRow( ) ; 

int column = currentColumn( ) + 1; 

while (row < RowCount) { 

while (column < ColumnCount) { 

if (text(row, column) .contains(str, cs)) { 
clearSelection() ; 
setCurrentCellfrow, column); 
activateWindowj ) ; 
return; 

} 

++column; 

} 

column = 0; 
++row; 

} 

QApplication: :beep( ) ; 

} 

Le slot f indNext ( ) parcourt les cellules en commencant par la cellule a droite du pointeur et 
en se dirigeant vers la droite jusqu'a la derniere colonne, puis il poursuit par la premiere 
colonne dans la ligne du dessous et ainsi de suite jusqu'a trouver le texte recherche ou jusqu'a 
atteindre la toute derniere cellule. Par exemple, si la cellule en cours est la cellule C24, nous 
recherchons D24, E24, Z24, puis A25, B25, C25, Z25, et ainsi de suite jusqu'a Z999. Si 
nous trouvons une correspondance, nous supprimons la selection actuelle, nous deplacons le 
pointeur vers cette cellule et nous activons la fenetre qui contient Spreadsheet. Si aucune 
correspondance n'est decouverte, l'application emet un signal sonore pour indiquer que la 
recherche n'a pas abouti. 

void Spreadsheet: :f indPreviousfconst QString &str, 

Qt: :CaseSensitivity cs) 

{ 
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int row = currentRow( ) ; 

int column = currentColumn( ) - 1; 

while (row >= 0) { 

while (column >= 0) { 

if (text (row, column) .contains(str, cs)) { 
clearSelection( ) ; 
setCurrentCell(row, column); 
activateWindow( ) ; 
return; 

} 

--column; 

} 

column = ColumnCount - 1 ; 
--row; 

} 

QApplication: :beep() ; 

} 

Le slot f indPrevious ( ) est similaire a f indNext ( ), sauf qu'il effectue une recherche dans 
l'autre sens et s'arrete a la cellule Al. 



Implementer les autres menus 

Nous allons maintenant implementer les slots des menus Tools et Options. Ces menus sont 
illustres en Figure 4.7. 

Figure 4.7 
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cell(row, column) ->setDirty( ) ; 

} 

} 

viewport ()->update() ; 

} 

Le slot recalculate ( ) correspond a Tools > Recalculate. II est aussi appele automatiquement 
par Spreadsheet si necessaire. 
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Nous parcourons toutes les cellules et invoquons setDirty ( ) sur chacune d'elles pour signaler 
celles qui doivent etre recalculees. La prochaine fois que QTableWidget appelle text( ) sur 
Cell pour obtenir la valeur a afficher dans la feuille de calcul, la valeur sera recalculee. 

Nous appelons ensuite update ( ) sur le viewport pour redessiner la feuille de calcul complete. 
Le code de reaffichage dans QTableWidget invoque ensuite text ( ) sur chaque cellule visible 
pour obtenir la valeur a afficher. Vu que nous avons appele setDirty ( ) sur chaque cellule, les 
appels de text ( ) utiliseront une valeur nouvellement calculee. Le calcul pourrait exiger que 
les cellules non visibles soient recalculees, repercutant la meme operation jusqu'a ce que chaque 
cellule qui a besoin d'etre recalculee pour afficher le bon texte dans le viewport ait une valeur 
reactualisee. Le calcul est effectue par la classe Cell. 

void Spreadsheet: :setAutoRecalculate(bool recalc) 
{ 

autoRecalc = recalc; 
if (autoRecalc) 
recalculate) ) ; 

} 

Le slot setAutoRecalculate ( ) correspond a Options > Auto-Recalculate. Si la fonction est 
activee, nous recalculons immediatement la feuille de calcul pour nous assurer qu'elle est a 
jour ; ensuite, recalculate ( ) est appele automatiquement dans somethingChanged ( ). 

Nous n' avons pas besoin d'implementer quoi que ce soit pour Options > Show Grid, parce que 
QTableWidget a deja un slot setShowGrid( ) qu'il a herite de sa classe de base QTableView. 
Tout ce qui reste, c'est Spreadsheet : : sort ( ) qui est invoquee dans MainWindow: : sort ( ) : 

void Spreadsheet: :sort(const SpreadsheetCompare &compare) 
{ 

QList<QStringList> rows; 

QTableWidgetSelectionRange range = selectedRange( ) ; 
int i; 

for (i = 0; i < range. rowCount() ; ++i) { 
QStringList row; 

for (int j = 0; j < range. columnCount() ; ++j) 
row.append(formula(range.topRow() + i, 

range. leftColumn() + j)); 

rows. append (row) ; 

} 

qStableSort(rows.begin() , rows.endf), compare); 

for (i = 0; i < range. rowCountf) ; ++i) { 
for (int j = 0; j < range. columnCount() ; 

setFormula( range. topRowf) + i, range. leftColumn() + j , 
rows[i][j]); 

} 

clearSelectionf) ; 
somethingChanged ( ) ; 

} 



94 Qt4 et C++ : Programmation d'interfaces GUI 



Le tri s'opere sur la selection actuelle et reorganise les lignes selon les cles et les ordres de tri 
stockes dans l'objet compare. Nous representons chaque ligne de donnees avec QStringList 
et nous conservons la selection sous forme de liste de lignes (voir Figure 4.8). Nous nous 
servons de l'algorithme qStableSort ( ) de Qt et pour une question de simplicite, le tri 
s'effectue sur la formule plutot que sur la valeur. Les algorithmes standards, de meme que les 
structures de donnees de Qt sont abordes au Chapitre 1 1 . 
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La fonction qStableSort ( ) recoit un iterateur de debut et de fin, ainsi qu'une fonction de compa- 
raison. La fonction de comparaison est une fonction qui recoit deux arguments (deux QString- 
List) et qui retourne true si le premier argument est "inferieur" au second argument et false 
dans les autres cas. L'objet compare que nous transmettons comme fonction de comparaison 
n'est pas vraiment une fonction, mais il peut etre utilise comme telle, comme nous allons le voir. 



Figure 4.9 
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Apres avoir execute qStableSort ( ), nous reintegrons les donnees dans la table (voir 
Figure 4.9), nous effacons la selection et nous appelons somethingChanged ( ). 

Dans spreadsheet . h, la classe SpreadsheetCompare etait definie comme suit : 

class SpreadsheetCompare 
{ 

public: 

bool operator( ) (const QStringList &row1 , 

const QStringList &row2) const; 

enum { KeyCount = 3 }; 

int keys [KeyCount] ; 

bool ascending[KeyCount] ; 

}; 

La classe SpreadsheetCompare est speciale parce qu'elle implemente un operateur (). Nous 
avons done la possibilite d'utiliser la classe comme si e'etait une fonction. De telles classes 
sont appelees des objets fonction, ou foncteurs. Pour comprendre comment fonctionnent les 
foncteurs, nous debutons par un exemple simple : 
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class Square 
{ 

public: 

int operator( ) (int x) const { return x * x; } 

} 

La classe Square fournit une fonction, operator( ) (int), qui retourne le carre de son para- 
metre. En nommant la fonction operator() (int), au lieu de compute(int) par exemple, 
nous avons la possibilite d'utiliser un objet de type Square comme si c'etait une fonction : 

Square square; 
int y = square(5) ; 

A present, analysons un exemple impliquant SpreadsheetCompare : 

QStringList rowl , row2; 
QSpreadsheetCompare compare; 

if ( compare ( rowl , row2)) { 
// rowl est inferieure a 

} 

L'objet compare peut etre employe comme s'il etait une fonction compare () ordinaire. De 
plus, son implementation peut acceder a toutes les cles et ordres de tri stockes comme variables 
membres. 

II existe une alternative : nous aurions pu conserver tous les ordres et cles de tri dans des variables 
globales et utiliser une fonction compare ( ) ordinaire. Cependant, la communication via les 
variables globales n'est pas tres elegante et peut engendrer des bogues subtils. Les foncteurs 
sont plus puissants pour interfacer avec des fonctions modeles comme qStableSort ( ). 

Voici F implementation de la fonction employee pour comparer deux lignes de la feuille de calcul : 

bool SpreadsheetCompare: :operator() (const QStringList &row1 , 

const QStringList &row2) const 

{ 

for (int i = 0; i < KeyCount; ++i) { 
int column = keys[i] ; 
if (column != -1 ) { 

if (rowl [column] != row2[column] ) { 
if (ascending[i] ) { 

return rowl [column] < row2[column] ; 
} else { 

return rowl [column] > row2[column] ; 

} 

} 

} 

} 

return false; 

} 



96 Qt4 et C++ : Programmation d'interfaces GUI 



Loperateur retourne true si la premiere ligne est inferieure a la seconde et false dans les 
autres cas. La fonction qStableSort ( ) utilise ce resultat pour effectuer le tri. 

Les tables keys et ascending de l'objet SpreadsheetCompare sont alimentees dans la fonction 
MainWindow: : sort ( ) (vue au Chapitre 2). Chaque cle possede un index de colonne ou -1 
("None"). 

Nous comparons les entrees de cellules correspondantes dans les deux lignes pour chaque cle 
dans l'ordre. Des que nous decouvrons une difference, nous retournons une valeur true ou 
false. S'il s'avere que toutes les comparaisons sont egales, nous retournons false. La fonc- 
tion qStableSort ( ) s'appuie sur l'ordre avant le tri pour resoudre les situations d'egalite ; si 
rowl precedait row2 a l'origine et n'est jamais "inferieur a" l'autre, rowl precedera toujours 
row2 dans le resultat. C'est ce qui distingue qStableSort ( ) de son cousin qSort ( ) dont le 
resultat est moins previsible. 

Nous avons desormais termine la classe Spreadsheet. Dans la prochaine section, nous allons 
analyser la classe Cell. Cette classe est employee pour contenir les formules des cellules et 
propose une reimplementation de la fonction QTableWidgetltem: :data( ) que 
Spreadsheet appelle indirectement par le biais de la fonction QTableWidgetltem: : text ( ). 
L'objectif est d'afficher le resultat du calcul de la formule d'une cellule. 

Derivation de QTableWidgetltem 

La classe Cell herite de QTableWidgetltem. Cette classe est concue pour bien fonctionner 
avec Spreadsheet, mais elle ne depend pas specifiquement de cette classe et pourrait, en 
theorie, etre utilisee dans n'importe quel QTableWidget. Voici le fichier d'en-tete : 

#ifndef CELL_H 
#define CELL_H 

#include <QTableWidgetItem> 

class Cell : public QTableWidgetltem 
{ 

public: 
Cell() ; 

QTableWidgetltem *clone() const; 

void setData(int role, const QVariant &value); 

QVariant data(int role) const; 

void setFormulafconst QString &formula); 

QString formulaf) const; 

void setDirty( ) ; 

private: 

QVariant value() const; 

QVariant evalExpression(const QString &str, int &pos) const; 
QVariant evalTermfconst QString &str, int &pos) const; 
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QVariant evalFactor(const QString &str, int &pos) const; 

mutable QVariant cachedValue; 
mutable bool cachelsDirty ; 

}; 

#endif 

La classe Cell developpe QTableWidgetltem en ajoutant deux variables privees : 

• cachedValue met en cache la valeur de la cellule sous forme de QVariant. 

• cachelsDirty est true si la valeur mise en cache n'est pas a jour. 

Nous utilisons QVariant parce que certaines cellules ont une valeur double alors que d'autres 
ont une valeur QString. 

Les variables cachedValue et cachelsDirty sont declarees avec le mot-cle C++ mutable. 
Nous avons ainsi la possibility de modifier ces variables dans des fonctions const. Nous pourrions 
aussi recalculer la valeur a chaque fois que text ( ) est appelee, mais ce serait tout a fait inefficace. 

Notez qu'il n'y a pas de macro Q_0BJECT dans la definition de classe. Cell est une classe C++ 
ordinaire, sans signaux ni slots. En fait, vu que QTableWidgetltem n'herite pas de QObj ect, 
nous ne pouvons pas avoir de signaux et de slots dans Cell. Les classes d'elements de Qt 
n'heritent pas de QObj ect pour optimiser les performances. Si des signaux et des slots se reve- 
lent necessaires, ils peuvent etre implemented dans le widget qui contient les elements ou, 
exceptionnellement, en utilisant l'heritage multiple avec QObj ect. 

Voici le debut de cell . cpp : 

#include <QtGui> 

#include "cell.h" 

Cell: :Cell() 
{ 

setDirty() ; 

} 

Dans le constructeur, nous devons simplement definir le cache comme etant a actualiser 
(dirty). Vous n'avez pas besoin de transmettre un parent ; quand la cellule est inseree dans un 
QTableWidget avec setltem(), le QTableWidget prend automatiquement possession de 
celle-ci. 

Chaque QTableWidgetltem peut contenir des donnees, jusqu'a un QVariant pour chaque 
"role" de donnees. Les roles les plus couramment utilises sont Qt::EditRole et 
Qt: : DisplayRole. Le role de modification est employe pour des donnees qui doivent etre 
modifiees et le role d'affichage pour des donnees qui doivent etre affichees. II arrive souvent 
que ces donnees soient les memes, mais dans Cell le role de modification correspond a la 
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formule de la cellule et le role d'affichage a la valeur de la cellule (le resultat de 1' evaluation de 
la formule). 

QTableWidgetltem *Cell: :clone() const 
{ 

return new Cell(*this); 

} 

La fonction clone () est invoquee par QTableWidget quand il doit creer une nouvelle 
cellule - par exemple quand l'utilisateur commence a taper dans une cellule vide qui n'a 
encore jamais ete utilisee. L'instance transmise a QTableWidget : : setltemPrototype ( ) est 
l'element qui est clone. Vu que la copie au niveau du membre est suffisante pour Cell, nous 
nous basons sur le constructeur de copie par defaut cree automatiquement par C++ dans le but 
de creer de nouvelles instances Cell dans la fonction clone ( ) . 

void Cell: :setFormula(const QString &formula) 
{ 

setData(Qt: :EditRole, formula); 

} 

La fonction setFormula( ) definit la formule de la cellule. C'est simplement une fonction 
pratique permettant d'appeler setData( ) avec le role de modification. Elle est invoquee dans 
Spreadsheet: : setFormula( ). 

QString Cell: : formula () const 
{ 

return data(Qt: :EditRole) .toString() ; 

} 

La fonction formula( ) est appelee dans Spreadsheet : :formula( ). Comme setFormula( ), 
c'est une fonction commode, mais cette fois-ci qui recupere les donnees EditRole de l'element. 

void Cell: :setData(int role, const QVariant Svalue) 
{ 

QTableWidgetltem: :setData(role, value) ; 
if (role == Qt: : EditRole) 
setDirty ( ) ; 

} 

Si nous avons affaire a une nouvelle formule, nous definissons cachelsDirty en true pour 
garantir que la cellule sera recalculee la prochaine fois que text ( ) est appele. 

Aucune fonction text ( ) n'est definie dans Cell, meme si nous appelons text ( ) sur des 
instances Cell dans Spreadsheet: :text(). La fonction text() est une fonction de 
convenance proposee par QTableWidgetltem ; cela revient au meme que d'appeler 
data(Qt: : DisplayRole) .toString(). 

void Cell: :setDirty() 
{ 

cachelsDirty = true; 

} 
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La fonction setDirty ( ) est invoquee pour forcer le recalcul de la valeur d'une cellule. Elle 
definit simplement cachelsDirty en true, ce qui signirie que cachedValue n'est plus a 
jour. Le recalcul n'est effectue que lorsqu'il est necessaire. 

QVariant Cell: :data(int role) const 
{ 

if (role == Qt: :DisplayRole) { 
if (value().isValid()) { 

return value() .toString() ; 
} else { 

return "####"; 

} 

} else if (role == Qt : :TextAlignmentRole) { 
if (value() .type() == QVariant: :String) { 

return int(Qt: :AlignLeft | Qt : :AlignVCenter) ; 
} else { 

return int(Qt: :AlignRight | Qt : :AlignVCenter) ; 

} 

} else { 

return QTableWidgetltem: :data(role) ; 

} 

} 

La fonction data() est reimplementee dans QTableWidgetltem. Elle retourne le texte qui 
doit etre affiche dans la feuille de calcul si elle est appelee avec Qt : : DisplayRole, et la 
formule si elle est invoquee avec Qt: :EditRole. Elle renvoie l'alignement approprie si elle 
est appelee avec Qt: : TextAlignmentRole. Dans le cas de DisplayRole, elle se base sur 
value () pour calculer la valeur de la cellule. Si la valeur n'est pas valide (parce que la 
formule est mauvaise), nous retournons "####". 

La fonction Cell : : value ( ) utilisee dans data ( ) retourne un QVariant. Un QVariant peut 
stocker des valeurs de differents types, comme double et QString, et propose des fonctions 
pour convertir les variants dans d'autres types. Par exemple, appeler toString() sur un 
variant qui contient une valeur double produit une chaine de double. Un QVariant construit 
avec le constructeur par defaut est un variant "invalide". 

const QVariant Invalid; 

QVariant Cell: : value( ) const 
{ 

if (cachelsDirty) { 

cachelsDirty = false; 

QString formulaStr = formula(); 
if (formulaStr. startsWithf ' \ 1 1 ) ) { 

cachedValue = formulaStr. mid (1 ) ; 
} else if (formulaStr. startsWith( '=') ) { 

cachedValue = Invalid; 

QString expr = formulaStr. mid(1 ) ; 

expr. replace) " ", ""); 

expr.append(QChar: :Null) ; 
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int pos = 0; 

cachedValue = evalExpressionfexpr, pos); 
if (expr[pos] != QChar: :Null) 
cachedValue = Invalid; 

} else { 
bool ok; 

double d = formulaStr.toDouble(&ok) ; 
if (ok) { 

cachedValue = d; 
} else { 

cachedValue = formulaStr; 

} 

} 

} 

return cachedValue; 

} 

La fonction privee value ( ) retourne la valeur de la cellule. Si cachelsDirty est true, nous 
devons la recalculer. 

Si la formule commence par une apostrophe (par exemple " ' 12345"), l'apostrophe se trouve a 
la position 0 et la valeur est la chaine allant de la position 1 a la fin. 

Si la formule commence par un signe egal (=), nous prenons la chaine a partir de la position 1 
et nous supprimons tout espace qu'elle contient. Nous appelons ensuite evalExpression ( ) 
pour calculer la valeur de l'expression. L' argument pos est transmis par reference ; il indique 
la position du caractere oil l'analyse doit commencer. Apres l'appel de evalExpression ( ) , le 
caractere a la position pos doit etre le caractere QChar : : Null que nous avons ajoute, s'il a ete 
correctement analyse. Si l'analyse a echoue avant la fin, nous definissons cachedValue de 
sorte qu'il soit Invalid. 

Si la formule ne commence pas par une apostrophe ni par un signe egal, nous essayons de la 
convertir en une valeur a virgule flottante a l'aide de toDouble ( ) . Si la conversion fonctionne, 
nous configurons cachedValue pour y stacker le nombre obtenu ; sinon, nous definissons 
cachedValue avec la chaine de la formule. Par exemple, avec une formule de "1,50," toDou- 
ble ( ) definit ok en true et retourne 1,5, alors qu'avec une formule de "World Population" 
toDouble ( ) definit ok en false et renvoie 0,0. 

En transmettant a toDouble ( ) un pointeur de type bool, nous sommes en mesure de faire une 
distinction entre la conversion d'une chaine qui donne la valeur numerique 0,0 et une erreur de 
conversion (oil 0,0 est aussi retourne mais bool est defini en false). II est cependant parfois 
necessaire de retourner une valeur zero sur un echec de conversion, auquel cas nous n' avons 
pas besoin de transmettre de pointeur de bool. Pour des questions de performances et de porta- 
bility, Qt n'utilise jamais d'exceptions C++ pour rapporter des echecs. Ceci ne vous empeche pas 
de les utiliser dans des programmes Qt, a condition que votre compilateur les prenne en charge. 

La fonction value ( ) est declaree const. Nous devions declarer cachedValue et cachels- 
Valid comme des variables mutable, de sorte que le compilateur nous permette de les modifier 
dans des fonctions const. Ce pourrait etre tentant de rendre value ( ) non-const et de supprimer 
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les mots cles mutable, mais le resultat ne compilerait pas parce que nous appelons value ( ) 
depuis data () , une fonction const. 

Nous avons desormais fini l'application Spreadsheet, excepte l'analyse des formules. Le reste 
de cette section est dediee a evalExpression ( ) et les deux fonctions evalTerm( ) et eval- 
Factor ( ) . Le code est un peu complique, mais il est introduit ici pour completer l'application. 
Etant donne que le code n'est pas lie a la programmation d'interfaces graphiques utilisateurs, 
vous pouvez tranquillement l'ignorer et continuer a lire le Chapitre 5. 

La fonction evalExpression ( ) retourne la valeur d'une expression dans la feuille de calcul. 
Une expression est definie sous la forme d'un ou plusieurs termes separes par les operateurs 
"+" ou "-".Les termes eux-memes sont definis comme un ou plusieurs facteurs separes par les 
operateurs "*" ou "/".En divisant les expressions en termes et les termes en facteurs, nous 
sommes surs que les operateurs sont appliques dans le bon ordre. 

Par exemple, "2*C5+D6" est une expression avec "2*C5" comme premier terme et "D6" 
comme second terme. Le terme "2*C5" a "2" comme premier facteur et "C5" comme 
deuxieme facteur, et le terme "D6" est constitue d'un seul facteur "D6".Un facteur peut etre un 
nombre ("2"), un emplacement de cellule ("C5") ou une expression entre parentheses, precedee 
facultativement d'un signe moins unaire. 
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Figure 4.10 

Diagramme de la syntaxe des expressions de la feuille de calcul 



La syntaxe des expressions de la feuille de calcul est presentee dans la Figure 4.10. Pour 
chaque symbole de la grammaire {Expression, Terme et Facteur), il existe une fonction membre 
correspondante qui l'analyse et dont la structure respecte scrupuleusement cette grammaire. 
Les analyseurs ecrits de la sorte sont appeles des analyseurs vers le bas recursifs. 

Commencons par evalExpression (), la fonction qui analyse une Expression : 

QVariant Cell: :evalExpression(const QString &str, int &pos) const 
{ 

QVariant result = evalTerm(str, pos); 
while (str[pos] != QChar: :Null) { 

QChar op = str[pos] ; 

if (op != ' + ' && op != '- 1 ) 
return result; 

++pos; 
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QVariant term = evalTerm(str, pos); 
if (result. type() == QVariant: :Double 

&& term.type() == QVariant: :Double) { 
if (op == '+') { 

result = result. toDouble() + term.toDouble() ; 
} else { 

result = result. toDoublef) - term.toDouble() ; 
} 

} else { 

result = Invalid; 

} 

} 

return result; 

} 

Nous appelons tout d'abord evalTerm ( ) pour obtenir la valeur du premier terme. Si le carac- 
tere suivant est "+" ou nous appelons evalTerm ( ) une deuxieme fois ; sinon, l'expres- 
sion est constituee d'un seul terme et nous retournons sa valeur en tant que valeur de toute 
l'expression. Une fois que nous avons les valeurs des deux premiers termes, nous calculons le 
resultat de l'operation en fonction de l'operateur. Si les deux termes ont ete evalues en double, 
nous calculons le resultat comme etant double ; sinon nous definissons le resultat comme 
etant Invalid. 

Nous continuons de cette maniere jusqu'a ce qu'il n'y ait plus de termes. Ceci fonctionne 
correctement parce que les additions et les soustractions sont de type associatif gauche ; c'est- 
a-dire que "1-2-3" signifie "(1-2)— 3" et non " 1— (2— 3)." 

QVariant Cell: :evalTerm(const QString &str, int &pos) const 
{ 

QVariant result = evalFactorfstr, pos); 
while (str[pos] != QChar::Null) { 

QChar op = str[pos] ; 

if (op != '*' && op != 1 / 1 ) 
return result; 

++pos; 

QVariant factor = evalFactor(str, pos); 
if (result .type() == QVariant: : Double 

&& factor. type() == QVariant: :Double) { 
if (op == '*') { 

result = result. toDouble() * factor. toDoublef ) ; 
} else { 

if (factor. toDouble() == 0.0) { 
result = Invalid; 

} else { 

result = result .toDouble( ) / f actor. toDoublef ) ; 

} 

} 

} else { 
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result = Invalid; 

} 

} 

return result; 

} 

La fonction evalTerm() ressemble beaucoup a evalExpression ( ), sauf qu'elle traite des 
multiplications et des divisions. La seule subtilite dans evalTerm(), c'est que vous devez 
eviter de diviser par zero, parce que cela constitue une erreur dans certains processeurs. Bien 
qu'il ne soit pas recommande de tester l'egalite de valeurs de type virgule flottante en raison 
des problemes d'arrondis, vous pouvez tester sans problemes l'egalite par rapport a 0,0 pour 
eviter toute division par zero. 

QVariant Cell: :evalFactor(const QString &str, int &pos) const 
{ 

QVariant result; 

bool negative = false; 

if (str[pos] == ' - ' ) { 
negative = true; 
++pos; 

} 

if (str[pos] == '(') { 
++pos; 

result = evalExpression(str, pos); 
if (str[pos] != ') ' ) 
result = Invalid; 
++pos; 
} else { 

QRegExp regExp( " [A-Za-z] [1-9] [0-9] {0,2}" ) ; 
QString token; 

while (str[pos] .isLetterOrNumber( ) || str[pos] == '.') { 
token += str[pos] ; 
++pos; 

} 

if (regExp.exactMatch(token) ) { 

int column = token[0] .toUpperf) .unicode() - 'A'; 
int row = token. mid(1 ) .toInt() - 1; 



Cell *c = static_cast<Cell *>( 

tableWidget()->item(row, column)) ; 

if (c) { 

result = c->value( ) ; 
} else { 

result = 0.0; 

} 

} else { 
bool ok; 

result = token. toDouble(&ok) ; 
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if (!ok) 

result = Invalid; 

} 

} 

if (negative) { 

if (result .type() == QVariant: :Double) { 

result = -result. toDoublef) ; 
} else { 

result = Invalid; 

} 

} 

return result; 

} 

La fonction evalFactor() est un peu plus compliquee que evalExpression ( ) et eval- 
Term( ). Nous regardons d'abord si le facteur est precede du signe negatif. Nous examinons 
ensuite s'il commence par une parenthese ouverte. Si c'est le cas, nous evaluons le contenu des 
parentheses comme une expression en appelant evalExpression ( ). Lorsque nous evaluons 
une expression entre parentheses, evalExpression ( ) appelle evalTerm(), qui invoque 
evalFactor ( ), qui appelle a nouveau evalExpression ( ). C'est la qu'intervient la recursi- 
vite dans l'analyseur. 

Si le facteur n'est pas une expression imbriquee, nous extrayons le prochain jeton, qui devrait 
etre un emplacement de cellule ou un nombre. Si le jeton correspond a QRegExp, nous le consi- 
derons comme une reference de cellule et nous appelons value ( ) sur la cellule a 1' emplace- 
ment donne. La cellule pourrait se trouver n'importe ou dans la feuille de calcul et pourrait etre 
dependante d'autres cellules. Les dependances ne sont pas un probleme ; elles declencheront 
simplement plus d'appels de value () et (pour les cellules "a recalculer") plus d'analyse 
jusqu'a ce que les valeurs des cellules dependantes soient calculees. Si le jeton n'est pas un 
emplacement de cellule, nous le considerons comme un nombre. 

Que se passe-t-il si la cellule Al contient la formule "=A1" ? Ou si la cellule Al contient 
"=A2" et la cellule A2 comporte "=A1" ? Meme si nous n'avons pas ecrit de code special pour 
detecter des dependances circulaires, l'analyseur gere ces cas en retournant un QVariant inva- 
lide. Ceci fonctionne parce que nous definissons cachelsDirty en false et cachedValue en 
Invalid dans value ( ) avant d'appeler evalExpression ( ). Si evalExpression ( ) appelle 
de maniere recursive value ( ) sur la meme cellule, il renvoie immediatement Invalidet toute 
l'expression est done evaluee en Invalid. 

Nous avons desormais termine l'analyseur de formules. II n'est pas complique de l'etendre 
pour qu'il gere des fonctions predefinies de la feuille de calcul, comme sum ( ) et avg ( ) , en 
developpant la definition grammaticale de Facteur. Une autre extension facile consiste a imple- 
menter l'operateur "+" avec des operandes de chaine (comme une concatenation) ; aucun chan- 
gement de grammaire n'est exige. 
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Ce chapitre vous explique comment concevoir des widgets personnalises a l'aide de Qt. 
Les widgets personnalises peuvent etre crees en derivant un widget Qt existant ou en 
derivant directement QWidget. Nous vous presenterons les deux approches et nous 
verrons egalement comment introduire un widget personnalise avec le Qt Designer de 
sorte qu'il puisse etre utilise comme n'importe quel widget Qt integre. Nous termine- 
rons ce chapitre en vous parlant d'un widget personnalise qui emploie la double mise en 
memoire tampon, une technique puissante pour actualiser tres rapidement l'affichage. 
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Personnaliser des widgets Qt 

II arrive qu'il ne soit pas possible d'obtenir la personnalisation requise pour un widget Qt 
simplement en configurant ses proprietes dans le Qt Designer ou en appelant ses fonctions. 
Une solution simple et directe consiste a deriver la classe de widget appropriee et a 1' adapter 
pour satisfaire vos besoins. 



Figure 5.1 

Le widget HexSpinBox 



IFF 



Dans cette section, nous developperons un pointeur toupie hexadecimal pour vous presenter 
son fonctionnement (voir Figure 5.1). QSpinBox ne prend en charge que les nombres deci- 
maux, mais grace a la derivation, il est plutot facile de lui faire accepter et afficher des valeurs 
hexadecimales. 

#ifndef HEXSPINBOX_H 
#define HEXSPINBOX_H 

#include <QSpinBox> 

class QRegExpValidator; 

class HexSpinBox : public QSpinBox 
{ 

Q_0BJECT 
public: 

HexSpinBox (QWidget *parent = 0); 
protected : 

QValidator: : State validate (QString &text, int &pos) const; 
int valueFromText (const QString &text) const; 
QString textFromValuefint value) const; 

private: 

QRegExpValidator *validator; 

}; 

#endif 

HexSpinBox herite la majorite de ses fonctionnalites de QSpinBox. II propose un constructeur 
typique et reimplemente trois fonctions virtuelles de QSpinBox . 

#include <QtGui> 

#include "hexspinbox.h" 

HexSpinBox: : HexSpinBox (QWidget *parent) 
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: QSpinBox(parent) 

{ 

setRange(0, 255); 

validator = new QRegExpValidator(QRegExp( " [0-9A-Fa-f ] {1 ,8}") , this); 

} 

Nous definissons la plage par defaut avec les valeurs 0 a 255 (0x00 a OxFF), qui est plus appro- 
priee pour un pointeur toupie hexadecimal que les valeurs par defaut de QSpinBox allant de 0 a 
99. 

L'utilisateur peut modifier la valeur en cours d'un pointeur toupie, soit en cliquant sur ses 
fleches vers le haut et le bas, soit en saisissant une valeur dans son editeur de lignes. Dans le 
second cas, nous souhaitons restreindre 1' entree de l'utilisateur aux nombres hexadecimaux vali- 
des. Pour ce faire, nous employons QRegExpValidator qui accepte entre un et huit caracteres, 
chacun d'eux devant appartenir a l'un des ensembles suivants, "0" a "9," "A" a "F" et "a" a "f". 

QValidator: :State HexSpinBox: : validate(QString &text, int &pos) const 
{ 

return validator->validate(text, pos); 

} 

Cette fonction est appelee par QSpinBox pour verifier que le texte saisi jusqu'a present est 
valide. II y a trois possibilites : Invalid (le texte ne correspond pas a l'expression reguliere), 
Intermediate (le texte est une partie plausible d'une valeur valide) et Acceptable (le texte 
est valide). QRegExpValidator possede une fonction validate () appropriee, nous retour- 
nons done simplement le resultat de son appel. En theorie, nous devrions renvoyer Invalid ou 
Intermediate pour les valeurs qui se situent en dehors de la plage du pointeur toupie, mais 
QSpinBox est assez intelligent pour detecter cette condition sans aucune aide. 

QString HexSpinBox: :textFromValue(int value) const 
{ 

return QString: :number(value, 16) .toUpper( ) ; 

} 

La fonction textFromValue ( ) convertit une valeur entiere en chaine. QSpinBox l'appelle 
pour mettre a jour la partie "editeur" du pointeur toupie quand l'utilisateur appuie sur les 
fleches haut et bas du pointeur. Nous utilisons la fonction statique QString : : number ( ) avec 
un second argument de 16 pour convertir la valeur en hexadecimal minuscule et nous appelons 
QString: :toUpper() sur le resultat pour le passer en majuscule. 

int HexSpinBox: : valueFromText (const QString &text) const 
{ 

bool ok; 

return text.toInt(&ok, 16); 

} 

La fonction valueFromText ( ) effectue une conversion inverse, d'une chaine en une valeur 
entiere. Elle est appelee par QSpinBox quand l'utilisateur saisit une valeur dans la zone de 
l'editeur du pointeur toupie et appuie sur Entree. Nous executons la fonction QString : : tolnt ( ) 
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pour essayer de convertir le texte en cours en une valeur entiere, toujours en base 16. Si la 
chaine n'est pas au format hexadecimal, ok est defini en false et toInt( ) retourne 0. Ici, 
nous ne sommes pas obliges d'envisager cette possibility, parce que le validateur n'accepte que 
la saisie de chaines hexadecimales valides. Au lieu de transmettre l'adresse d'une variable sans 
interet (ok), nous pourrions transmettre un pointeur nul comme premier argument de tolnt ( ) . 

Nous avons termine le pointeur toupie hexadecimal. La personnalisation d'autres widgets Qt 
suit le meme processus : choisir un widget Qt adapte, le deriver et reimplementer certaines 
fonctions virtuelles pour modifier son comportement. 

Deriver QWidget 

De nombreux widgets personnalises sont simplement obtenus a partir d'une combinaison de 
widgets existants, que ce soit des widgets Qt integres ou d'autres widgets personnalises 
comme HexSpinBox. Les widgets personnalises ainsi concus peuvent generalement etre deve- 
loppes dans le Qt Designer : 

• creez un nouveau formulaire a l'aide du modele "Widget" ; 

• ajoutez les widgets necessaires au formulaire, puis disposez-les ; 

• etablissez les connexions entre les signaux et les slots. 

• Si vous avez besoin d'un comportement pour lequel de simples signaux et slots sont insuf- 
fisants, ecrivez le code necessaire dans une classe qui herite de QWidget et de celle generee 
par uic. 

II est evident que combiner des widgets existants peut se faire entierement dans du code. 
Quelle que soit l'approche choisie, la classe en resultant herite directement de QWidget. 

Si le widget ne possede aucun signal ni slot et qu'il ne reimplemente pas de fonction virtuelle, il 
est meme possible de concevoir le widget simplement en combinant des widgets existants sans 
sous-classe. C'est la technique que nous avons employee dans le Chapitre 1 pour creer l'appli- 
cation Age, avec QWidget, QSpinBox et QSlider. Pourtant nous aurions pu tout aussi facilement 
deriver QWidget et creer QSpinBox et QSlider dans le constructeur de la sous-classe. 

Lorsqu'aucun des widgets Qt ne convient a une tache particuliere et lorsqu'il n'existe aucun 
moyen de combiner ou d'adapter des widgets existants pour obtenir le resultat souhaite, nous 
pouvons toujours creer le widget que nous desirons. Pour ce faire, nous devons deriver QWid- 
get et reimplementer quelques gestionnaires d'evenements pour dessiner le widget et repondre 
aux clics de souris. Cette approche nous autorise une liberte totale quant a la definition et au 
controle de l'apparence et du comportement de notre widget. Les widgets integres de Qt, 
comme QLabel, QPushButton et QTableWidget, sont implemented de cette maniere. S'ils 
n'existaient pas dans Qt, il serait encore possible de les creer nous-memes en utilisant les fonctions 
publiques fournies par QWidget de facon totalement independante de la plate-forme. 
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Pour vous montrer comment ecrire un widget personnalise en se basant sur cette technique, 
nous allons creer le widget IconEditor illustre en Figure 5.2. IconEditor est un widget qui 
pourrait etre utilise dans un programme d'editeur d'icones. 



Figure 5.2 

Le widget IconEditor 




Commencons par analyser le fichier d'en-tete. 

#ifndef IC0NEDIT0R_H 
#define IC0NEDIT0R_H 

#include <QColor> 
#include <QImage> 
#include <QWidget> 

class IconEditor : public QWidget 
{ 

Q_0BJECT 

Q_PROPERTY(QColor penColor READ penColor WRITE setPenColor) 
Q_PROPERTY(QImage iconlmage READ iconlmage WRITE setlconlmage) 
Q_PROPERTY(int zoomFactor READ zoomFactor WRITE setZoomFactor) 

public: 

IconEditorfQWidget *parent = 0); 

void setPenColorfconst QColor &newColor); 
QColor penColorf) const { return curColor; } 

void setZoomFactor (int newZoom); 
int zoomFactor() const { return zoom; } 
void setIconImage(const Qlmage &newlmage); 
Qlmage iconlmagef) const { return image; } 
QSize sizeHint() const; 

La classe IconEditor utilise la macro Q_PROPERTY( ) pour declarer trois proprietes person- 
nalisees : penColor, iconlmage et zoomFactor. Chaque propriete a un type de donnees, une 
fonction de "lecture" et une fonction facultative "d'ecriture".Par exemple, la propriete penColor est 
de type QColor et peut etre lue et ecrite grace aux fonctions penColor ( ) et setPenColor ( ) . 
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Quand nous utilisons le widget dans le Qt Designer, les proprietes personnalisees apparaissent 
dans l'editeur de proprietes du Qt Designer sous les proprietes heritees de QWidget. Ces 
proprietes peuvent etre de n'importe quel type pris en charge par QVariant. La macro 
Q_0BJECT est necessaire pour les classes qui definissent des proprietes. 

protected: 

void mousePressEvent(QMouseEvent *event); 
void mouseMoveEvent (QMouseEvent *event); 
void paintEventfQPaintEvent *event); 

private: 

void setImagePixel(const QPoint &pos, bool opaque); 
QRect pixelRectfint i, int j) const; 

QColor curColor; 
Qlmage image; 
int zoom; 

}; 

#endif 

IconEditor reimplemente trois fonctions protegees de QWidget et possede quelques fonctions 
et variables privees. Les trois variables privees contiennent les valeurs des trois proprietes. 

Le fichier d' implementation commence par le constructeur de IconEditor : 

#include <QtGui> 

#include "iconeditor.h" 

IconEditor: : IconEditor(QWidget *parent) 
: QWidget (parent) 

{ 

setAttribute(Qt: :WA_StaticContents) ; 

setSizePolicy(QSizePolicy : :Minimum, QSizePolicy: :Minimum) ; 

curColor = Qt: : black; 
zoom = 8; 

image = QImage(16, 16, Qlmage: :Format_ARGB32) ; 
image. fill(qRgba(0, 0, 0, 0)); 

} 

Le constructeur presente certains aspects subtils, tels que l'attribut Qt : : WA_StaticContents 
et l'appel de setSizePolicy(). Nous y reviendrons dans un instant. 

La couleur du crayon est definie en noir. Le facteur de zoom est de 8, ce qui signifie que 
chaque pixel de l'icone sera afhche sous forme d'un carre de 8 X 8. 

Les donnees de l'icone sont stockees dans la variable membre image et sont disponibles par le 
biais des fonctions setlconlmage ( ) et iconImage() . Un programme d'editeur d'icones 
appellerait normalement setlconlmage ( ) quand l'utilisateur ouvre un fichier d'icone et 
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iconlmageO pour recuperer l'icone quand l'utilisateur veut la sauvegarder. La variable 
image est de type Qlmage. Nous l'initialisons a 16 X 16 pixels et au format ARGB 32 bits, un 
format qui prend en charge la semi-transparence. Nous effacons les donnees de 1' image en la 
remplissant avec une couleur transparente. 

La classe Qlmage stocke une image independamment du materiel. Elle peut etre definie avec 
une qualite de 1, 8 ou 32 bits. Une image avec une qualite de 32 bits utilise 8 bits pour chaque 
composante rouge, vert et bleu d'un pixel. Les 8 bits restants stockent le canal alpha du pixel 
(opacite). Par exemple, les composantes rouge, vert, bleu et alpha d'une couleur rouge pure 
presentent les valeurs 255, 0, 0 et 255. Dans Qt, cette couleur peut etre specifiee comme telle : 

QRgb red = qRgba(255, 0, 0, 255); 

ou, etant donne que la couleur est opaque, comme 
QRgb red = qRgb(255, 0, 0) ; 

QRgb est simplement le typedef d'un type unsigned int, et qRgb() et qRgba() sont des 
fonctions en ligne qui combinent leurs arguments en une valeur entiere 32 bits. II est aussi 
possible d'ecrire 

QRgb red = 0xFFFF0000; 

ou le premier FF correspond au canal alpha et le second FF a la composante rouge. Dans le 
constructeur de IconEditor, nous remplissons Qlmage avec une couleur transparente en utilisant 
0 comme canal alpha. 

Qt propose deux types permettant de stocker les couleurs : QRgb et QColor. Alors que QRgb est 
un simple typedef employe dans Qlmage pour stocker les donnees 32 bits du pixel, QColor est une 
classe dotee de nombreuses fonctions pratiques qui est souvent utilisee dans Qt pour stocker 
des couleurs. Dans le widget IconEditor, nous employons uniquement QRgb lorsque nous 
travaillons avec Qlmage ; nous utilisons QColor pour tout le reste, notamment la propriete 
penColor. 

QSize IconEditor: :sizeHint() const 
{ 

QSize size = zoom * image. size( ) ; 
if (zoom >= 3) 

size += QSize (1 , 1 ) ; 
return size; 

} 

La fonction sizeHint( ) est reimplementee dans QWidget et retourne la taille ideale d'un 
widget. Dans ce cas, nous recevons la taille de 1' image multipliee par le facte ur de zoom, avec 
un pixel supplemental dans chaque direction pour s' adapter a une grille si le facte ur de zoom 
est de 3 ou plus. (Nous n'affichons pas de grille si le facteur de zoom est de 2 ou 1, parce 
qu'elle ne laisserait presque pas de place pour les pixels de l'icone.) 
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La taille requise d'un widget est utile dans la plupart des cas lorsqu'elle est associee aux dispo- 
sitions. Les gestionnaires de disposition de Qt essaient au maximum de respecter cette taille 
quand ils disposent les widgets enfants d'un formulaire. Pour que IconEditor se comporte 
correctement, il doit signaler une taille requise credible. 

En plus de cette taille requise, la taille des widgets suit une strategie qui indique au systeme de 
disposition s'ils peuvent etre etires ou retrecis. En appelant setSizePolicy ( ) dans le constructeur 
avec les strategies horizontale et verticale QSizePolicy: : Minimum, tout gestionnaire de 
disposition responsable de ce widget sait que la taille requise de ce dernier correspond vrai- 
ment a sa taille minimale. En d'autres termes, le widget peut etre etire si necessaire, mais ne 
doit jamais etre retreci a une taille inferieure a la taille requise. Vous pouvez annuler ce 
comporte ment dans le Qt Designer en configurant la propriete sizePolicy du widget. 
La signification des diverses strategies liees a la taille est expliquee au Chapitre 6. 

void IconEditor: : setPenColorfconst QColor SnewColor) 
{ 

curColor = newColor; 

} 

La fonction setPenColor( ) definit la couleur du crayon. La couleur sera utilisee pour les 
pixels que vous dessinerez. 

void IconEditor: :setIconImage(const Qlmage &newlmage) 
{ 

if (newlmage != image) { 

image = newlmage. convertToFormat (Qlmage : :Format_ARGB32) ; 
updated ; 
updateGeometry( ) ; 

} 

} 

La fonction setlconlmageO determine 1' image a modifier. Nous invoquons convertTo- 
Format ( ) pour obtenir une image 32 bits avec une memoire tampon alpha si elle n'est pas 
dans ce format. Ailleurs dans le code, nous supposerons que les donnees de V image sont stockees 
sous forme de valeurs ARGB 32 bits. 

Apres avoir configure la variable image, nous appelons (Midget : : update ( ) pour forcer le 
rafraichissement de l'affichage du widget avec la nouvelle image. Nous invoquons ensuite 
QWidget : : updateGeometry ( ) pour informer toute disposition qui contient le widget que 
la taille requise du widget a change. La disposition s'adaptera automatiquement a cette 
nouvelle taille. 

void IconEditor: : setZoomFactor(int newZoom) 
{ 

if (newZoom < 1 ) 
newZoom = 1 ; 



if (newZoom != zoom) { 
zoom = newZoom; 
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update)) ; 
updateGeometry) ) ; 

} 

} 

La fonction setZoomFactor ( ) definit le facteur de zoom de l'image. Pour eviter une division 
par zero, nous corrigeons toute valeur inferieure a 1. A nouveau, nous appelons update ( ) et 
updateGeometry() pour actualiser l'affichage du widget et pour informer tout gestionnaire 
de disposition de la modification de la taille requise. 

Les fonctions penColor(), iconImage() et zoomFactor ( ) sont implementees en tant que 
fonctions en ligne dans le fichier d'en-tete. 

Nous allons maintenant passer en revue le code de la fonction paint Event ( ). Cette fonction 
est la fonction la plus importante de IconEditor. Elle est invoquee des que le widget a besoin 
d'etre redessine. L' implementation par defaut dans QWidget n'a aucune consequence, le 
widget reste vide. 

Tout comme closeEvent(), que nous avons rencontre dans le Chapitre 3, paintEvent() est 
un gestionnaire d'evenements. Qt propose de nombreux autres gestionnaires d'evenements, 
chacun d'eux correspondant a un type different d' evenement. Le Chapitre 7 aborde en detail le 
traitement des evenements. 

II existe beaucoup de situations oil un evenement paint est declenche et ou paintEvent ( ) 
est appele : 

• Quand un widget est affiche pour la premiere fois, le systeme genere automatiquement un 
evenement paint pour obliger le widget a se dessiner lui-meme. 

• Quand un widget est redimensionne, le systeme declenche un evenement paint. 

• Si le widget est masque par une autre fenetre, puis affiche a nouveau, un evenement paint 
est declenche pour la zone qui etait masquee (a moins que le systeme de fenetrage ait 
stocke la zone). 

Nous avons aussi la possibility de forcer un evenement paint en appelant QWidget: : up- 
date ( ) ou QWidget : : repaint ( ). La difference entre ces deux fonctions est que repaint ( ) 
impose un rafraichissement immediat de l'affichage, alors que update) ) planifie simplement 
un evenement paint pour le prochain traitement d'evenements de Qt. (Ces deux fonctions ne 
font rien si le widget n'est pas visible a l'ecran.) Si update) ) est invoque plusieurs fois, Qt 
compresse les evenements paint consecutifs en un seul evenement paint pour eviter le 
phenomene du scintillement. Dans IconEditor, nous utilisons toujours update) ). 

Voici le code : 

void IconEditor: : paintEvent(QPaintEvent *event) 
{ 

QPainter painter(this) ; 

if (zoom >= 3) { 

painter. setPen(palette)) .foreground)) .color)) ) ; 
for (int i = 0; i <= image. width)) ; ++i) 
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painter. drawLine(zoom * i, 0, 

zoom * i, zoom * image. height ()) ; 
for (int j = 0; j <= image. height () ; ++j) 
painter. drawLine(0, zoom * j, 

zoom * image. width ( ) , zoom * j); 



} 



for (int i = 0; i < image. width ( ) ; ++i) { 

for (int j = 0; j < image. height () ; ++j) { 
QRect rect = pixelRect(i, j); 
if ( !event->region( ) .intersect (rect) . isEmptyf ) ) { 

QColor color = QColor: :f romRgba( image. pixel (i, j)); 
painter. fillRect(rect, color); 

} 



Nous commencons par construire un objet QPainter sur le widget. Si le facteur de zoom est 
de 3 ou plus, nous dessinons des lignes horizontales et verticales qui forment une grille a l'aide 
de la fonction QPainter : : drawLine ( ). 

Un appel de QPainter : : drawLine ( ) presente la syntaxe suivante : 
painter. drawLine(x1 , y1 , x2, y2); 

ou (x1 , y1 ) est la position d'une extremite de la ligne et (x2, y2) la position de l'autre 
extremite. II existe egalement une version surcharged de la fonction qui recoit deux QPoint au 
lieu de quatre int. 

Le pixel en haut a gauche d'un widget Qt se situe a la position (0, 0), et le pixel en bas a droite 
se trouve a (width ( ) - 1, height () - 1 ). Cela ressemble au systeme traditionnel de coor- 
donnees cartesiennes, mais a l'envers. Nous avons la possibility de modifier le systeme de 
coordonnees de QPainter grace aux transformations, comme la translation, la mise a 
l'echelle, la rotation et le glissement. Ces notions sont abordees au Chapitre 8 (Graphiques 2D 
et 3D). 

Figure 5.3 (0> 0 ) 

Tracer une ligne P 
avec QPainter (x , y ) 



} 



} 



} 




(width() -1 .heightQ -1) 
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Avant d'appeler drawLine ( ) sur QPainter, nous dehnissons la couleur de la ligne au moyen 
de setPen ( ) . Nous pourrions coder une couleur, comme noir ou gris, mais il est plus judicieux 
d'utiliser la palette du widget. 

Chaque widget est dote d'une palette qui specifie quelles couleurs doivent etre utilisees selon 
les situations. Par exemple, il existe une entree dans la palette pour la couleur d'arriere-plan 
des widgets (generalement gris clair) et une autre pour la couleur du texte sur ce fond (habi- 
tuellement noir). Par defaut, la palette d'un widget adopte le modele de couleur du systeme de 
fenetrage. En utilisant des couleurs de la palette, nous sommes surs que IconEditor respecte 
les preferences de l'utilisateur. 

La palette d'un widget consiste en trois groupes de couleurs : active, inactive et disabled. 
Vous choisirez le groupe de couleurs en fonction de l'etat courant du widget : 

• Le groupe Active est employe pour des widgets situes dans la fenetre actuellement active. 

• Le groupe I nactive est utilise pour les widgets des autres fenetres. 

• Le groupe Disabled est utilise pour les widgets desactives dans n'importe quelle fenetre. 

La fonction QWidget : : palette ( ) retourne la palette du widget sous forme d'objet QPalette. 
Les groupes de couleurs sont specifies comme des enumerations de type QPalette : : Color- 
Group. 

Lorsque nous avons besoin d'un pinceau ou d'une couleur appropriee pour dessiner, la bonne 
approche consiste a utiliser la palette courante, obtenue a partir de QWidget : :palette(), et 
le role requis, par exemple, QPalette : : foreground ( ). Chaque fonction de role retourne un 
pinceau, qui correspond normalement a ce que nous souhaitons, mais si nous n'avons besoin 
que de la couleur, nous pouvons l'extraire du pinceau, comme nous avons fait dans paint - 
Event ( ) . Par defaut, les pinceaux retournes sont adaptes a l'etat du widget, nous ne sommes 
done pas forces de specifier un groupe de couleurs. 

La fonction paintEvent() termine en dessinant l'image elle-meme. L'appel de IconEdi- 
tor : : pixelRect ( ) retourne un QRect qui definit la region a redessiner. Pour une question 
d' optimisation simple, nous ne redessinons pas les pixels qui se trouvent en dehors de cette 
region. 

Figure 5.4 (Q> Q) 

Dessiner un rectangle 
avec QPainter 
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Nous invoquons QPainter: :fillRect() pour dessiner un pixel sur lequel un zoom a ete 
effectue. QPainter: :fillRect() recoit un QRect et un QBrush. En transmettant QColor 
comme pinceau, nous obtenons un modele de remplissage correct. 

QRect IconEditor: :pixelRect(int i, int j) const 
{ 

if (zoom >= 3) { 

return QRectfzoom * i + 1, zoom * j + 1, zoom - 1, zoom - 1); 
} else { 

return QRectfzoom * i, zoom * j, zoom, zoom); 

} 

} 

La fonction pixelRect() retourne un QRect adapte a QPainter: : fillRect ( ) . Les para- 
metres i et j sont les coordonnees du pixel dans Qlmage - pas dans le widget. Si le facteur de 
zoom est de 1 , les deux systemes de coordonnees coincident parfaitement. 

Le constructeur de QRect suit la syntaxe QRect (x, y, width, height), ou (x, y) est la 
position du coin superieur gauche du rectangle et width _ height correspond a la taille du 
rectangle. Si le facteur de zoom est de 3 ou plus, nous reduisons la taille du rectangle d'un pixel 
horizontalement et verticalement, de sorte que le remplissage ne deborde pas sur les lignes de la 
grille. 

void IconEditor: :mousePressEvent(QMouseEvent *event) 
{ 

if (event->button() == Qt: :LeftButton) { 

setImagePixel(event->pos( ) , true) ; 
} else if (event->button() == Qt: :RightButton) { 

setImagePixel(event->pos( ) , false) ; 

} 

} 

Quand l'utilisateur appuie sur un bouton de la souris, le systeme declenche un evenement 
"bouton souris enfonce". En reimplementant QWidget : : mousePressEvent ( ), nous avons la 
possibility de repondre a cet evenement et de definir ou effacer le pixel de F image sous le pointeur 
de la souris. 

Si l'utilisateur a appuye sur le bouton gauche de la souris, nous appelons la fonction privee 
setlmagePixel ( ) avec true comme second argument, lui demandant de definir le pixel dans 
la couleur actuelle du crayon. Si l'utilisateur a appuye sur le bouton droit de la souris, nous 
invoquons aussi setlmagePixel ( ), mais nous transmettons false pour effacer le pixel. 

void IconEditor: :mouseMoveEvent(QMouseEvent *event) 
{ 

if (event->buttons() & Qt: :LeftButton) { 

setImagePixel(event->pos( ) , true) ; 
} else if (event->buttons( ) & Qt: :RightButton) { 

setImagePixel(event->pos( ) , false) ; 

} 

} 
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mouseMoveEvent ( ) gere les evenements "emplacement de souris".Par defaut, ces evenements 
ne sont declenches que lorsque l'utilisateur enfonce un bouton. II est possible de changer ce 
comportement en appelant QWidget : : setMouseTracking ( ), mais nous n'avons pas besoin 
d'agir de la sorte dans cet exemple. 

Tout comme le fait d'appuyer sur les boutons droit ou gauche de la souris configure ou efface 
un pixel, garder ce bouton enfonce et se placer sur un pixel suffit aussi a definir ou supprimer 
un pixel. Vu qu'il est possible de maintenir enfonce plus d'un bouton a la fois, la valeur retour- 
nee par QMouseEvent : : buttons () est un operateur OR bit a bit des boutons de la souris. 
Nous testons si un certain bouton est enfonce a l'aide de l'operateur &, et si e'est le cas, nous 
invoquons setImagePixel( ) . 

void IconEditor: : setImagePixel(const QPoint &pos, bool opaque) 
{ 

int i = pos.x() / zoom; 
int j = pos.y() / zoom; 

if (image. rect() .containsfi, j)) { 
if (opaque) { 

image. setPixel(i, j, penColor( ) . rgba( ) ) ; 
} else { 

image. setPixel(i, j, qRgba(0, 0, 0, 0)); 

} 

update (pixelRect(i, j)); 

} 

} 

La fonction setImagePixel( ) est appelee depuis mousePressEvent ( ) et mouseMove- 
Event () pour definir ou effacer un pixel. Le parametre pos correspond a la position de la 
souris dans le widget. 

La premiere etape consiste a convertir la position de la souris dans les coordonnees du widget 
vers les coordonnees de 1' image. Pour ce faire, les composants x ( ) et y ( ) de la position de la 
souris sont divises par le facteur de zoom. Puis nous verifions si le point se trouve dans une 
plage correcte. Ce controle s'effectue facilement en utilisant Qlmage : : rect ( ) et 
QRect : : contains ( ) ; vous verifiez ainsi que i se situe entre 0 et image . width ( ) - 1 et que j 
est entre 0 et image . height ( ) - 1. 

Selon le parametre opaque, nous definissons ou nous effacons le pixel dans l'image. Effacer un 
pixel consiste a le rendre transparent. Nous devons convertir le crayon QColor en une valeur 
ARGB 32 bits pour l'appel de Qlmage : : setPixel ( ). Nous terminons en appelant update ( ) 
avec un QRect de la zone qui doit etre redessinee. 

Maintenant que nous avons analyse les fonctions membres, nous allons retourner l'attribut 
Qt : :WA_StaticContents que nous avons utilise dans le constructeur. Cet attribut informe Qt 
que le contenu du widget ne change pas quand le widget est redimensionne et que le contenu 
reste ancre dans le coin superieur gauche du widget. Qt se sert de ces informations pour eviter 
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tout retracage inutile des zones qui sont deja affichees au moment du redimensionnement du 
widget. 

Normalement, quand un widget est redimensionne, Qt declenche un evenement paint pour 
toute la zone visible du widget (voir Figure 5.5). Mais si le widget est cree avec l'attribut 
Qt : :WA_StaticContents, la region de l'evenement paint se limite aux pixels qui n'etaient 
pas encore affiches auparavant. Ceci implique que si le widget est redimensionne dans une 
taille plus petite, aucun evenement paint ne sera declenche. 



Le widget IconEditor est maintenant termine. Grace aux informations et aux exemples des 
chapitres precedents, nous pourrions ecrire un code qui utilise IconEditor comme une verita- 
ble fenetre, comme un widget central dans QMainWindow, comme un widget enfant dans une 
disposition ou comme un widget enfant dans QScrollArea. Dans la prochaine section, nous 
verrons comment l'integrer avec le Qt Designer. 



Integrer des widgets personnalises avec le Qt 
Designer 



Avant de pouvoir utiliser des widgets personnalises dans le Qt Designer, celui-ci doit en avoir 
connaissance. II existe deux techniques : la "promotion" et le plug-in. 

L'approche de la promotion est la plus rapide et la plus simple. Elle consiste a choisir un 
widget Qt integre qui possede une API similaire a celle que nous voulons pour notre widget 
personnalise, puis a saisir quelques informations a propos de ce widget personnalise dans une 
boite de dialogue du Qt Designer. Le widget peut ensuite etre exploite dans des formulaires 
developpes avec le Qt Designer, me me s'il sera represents par le widget Qt integre associe lors 
de l'edition ou de la previsualisation du formulaire. 

Voici comment inserer un widget HexSpinBox dans un formulaire avec cette approche : 
1. Creez un QSpinBox en le faisant glisser depuis la boite des widgets du Qt Designer vers le 



2. Cliquez du bouton droit sur le pointeur toupie et selectionnez Promote to Custom Widget 
dans le menu contextuel. 

3. Completez la boite de dialogue qui s'ouvre avec "HexSpinBox" comme nom de classe et 
"hexspinbox.h" comme fichier d'en-tete (voir Figure 5.6). 



Figure 5.5 

Redimensionner 
un widget 

Qt: : WA_StaticContents 




formulaire. 
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Voila ! Le code genere par uic contiendra hexspinbox . h au lieu de <QSpinBox> et instan- 
ciera un HexSpinBox. Dans le Qt Designer, le widget HexSpinBox sera represents par un 
QSpinBox, ce qui nous permet de definir toutes les proprietes d'un QSpinBox (par exemple, la 
plage et la valeur actuelle). 



Figure 5.6 

La boite de dialogue 
du widget personnalise 
dans le Qt Designer 



© G © Promote to Custom Widget 

Base class name: ospmft>x 



Custom class name: HexSpinBox 
Header file: hexspinbox. h 



Cancel I 



Les inconvenients de l'approche de la promotion sont que les proprietes specifiques au widget 
personnalise ne sont pas accessibles dans le Qt Designer et que le widget n'est pas affiche en 
tant que tel. Ces deux problemes peuvent etre resolus en utilisant l'approche du plug-in. 

L'approche du plug-in necessite la creation d'une bibliotheque de plug-in que le Qt Designer 
peut charger a l'execution et utiliser pour creer des instances du widget. Le veritable widget est 
ensuite employe par le Qt Designer pendant la modification du formulaire et la previsualisa- 
tion, et grace au systeme de meta-objets de Qt, le Qt Designer peut obtenir dynamiquement la 
liste de ses proprietes. Pour voir comment cela fonctionne, nous integrerons le widget 
I con Ed it or de la section precedente comme plug-in. 

Nous devons d'abord deriver QDesignerCustomWidgetlnterf ace et reimplementer certai- 
nes fonctions virtuelles. Nous supposerons que le code source du plug-in se situe dans un 
repertoire appele iconeditorplugin et que le code source de IconEditor se trouve dans 
un repertoire parallele nomme iconeditor. 

Voici la definition de classe : 

#include QDesignerCustomWidgetlnterf ace> 

class IconEditorPlugin : public QObject, 

public QDesignerCustomWidgetlnterf ace 

{ 

Q_0BJECT 

Q_INTERFACES (QDesignerCustomWidgetlnterf ace) 
public: 

IconEditorPlugin(QObject *parent = 0); 

QString name() const; 
QString includeFile() const; 
QString group() const; 
Qlcon icon() const; 
QString toolTipf) const; 
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QString whatsThis() const; 

bool isContainer( ) const; 

QWidget *createWidget(QWidget *parent); 

}; 

La sous-classe IconEditorPlugin est une classe specialisee qui encapsule le widget 
IconEditor. Elle herite de QObj ect et de QDesignerCustomWidgetlterf ace et se sert de 
la macro Q_INTERFACES ( ) pour signaler a moc que la seconde classe de base est une interface 
de plug-in. Les fonctions sont utilisees par le Qt Designer pour creer des instances de la classe 
et obtenir des informations a son sujet. 

IconEditorPlugin: :IconEditorPlugin(QObject *parent) 
: QObject(parent) 

{ 
} 

Le constructeur est tres simple. 

QString IconEditorPlugin: :name() const 
{ 

return "IconEditor"; 

} 

La fonction name ( ) retourne le nom du widget fourni par le plug-in. 

QString IconEditorPlugin: :includeFile() const 
{ 

return "iconeditor.h" ; 

} 

La fonction includeFile ( ) retourne le nom du fichier d'en-tete pour le widget specifie 
encapsule par le plug-in. Le fichier d'en-tete se trouve dans le code genere par l'outil uic. 

QString IconEditorPlugin: :group() const 
{ 

return tr( "Image Manipulation Widgets"); 

} 

La fonction group ( ) retourne le nom du groupe de widgets auquel doit appartenir ce widget 
personnalise. Si le nom n'est pas encore utilise, le Qt Designer creera un nouveau groupe pour 
le widget. 

Qlcon IconEditorPlugin: :icon( ) const 
{ 

return QIcon( " : /images/iconeditor.png" ) ; 

} 

La fonction icon ( ) renvoie l'icone a utiliser pour representer le widget personnalise dans la 
boite des widgets du Qt Designer. Dans notre cas, nous supposons que IconEditorPlugin 
possede un fichier de ressources Qt associe avec une entree adaptee pour l'image de l'editeur 
d'icones. 
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QString IconEditorPlugin: :toolTip() const 
{ 

return tr("An icon editor widget"); 

} 

La fonction toolTip() renvoie l'infobulle a afficher quand la souris se positionne sur le 
widget personnalise dans la boite des widgets du Qt Designer. 

QString IconEditorPlugin: :whatsThis() const 
{ 

return tr("This widget is presented in Chapter 5 of <i>C++ GUI " 

"Programming with Qt 4</i> as an example of a custom Qt " 
"widget . " ) ; 

} 

La fonction whatsThis ( ) retourne le texte "What's this ?" que le Qt Designer doit afficher. 

bool IconEditorPlugin: :isContainer( ) const 
{ 

return false; 

} 

La fonction isContainer ( ) retourne true si le widget peut contenir d'autres widgets ; sinon 
elle retourne false. Par exemple, QFrame est un widget qui peut comporter d'autres widgets. 
En general, tout widget Qt peut renfermer d'autres widgets, mais le Qt Designer ne l'autorise 
pas quand isContainer ( ) renvoie false. 

QWidget *IconEditorPlugin: :createWidget(QWidget *parent) 
{ 

return new IconEditor(parent) ; 

} 

La fonction create() est invoquee par le Qt Designer pour creer une instance d'une classe de 
widget avec le parent donne. 

Q_EXP0RT_PLUGIN2(iconeditorplugin, IconEditorPlugin) 

A la fin du fichier source qui implemente la classe de plug-in, nous devons utiliser la macro 
Q_EXP0RT_PLUGIN2( ) pour que le Qt Designer puisse avoir acces au plug-in. Le premier 
argument est le nom que nous souhaitons attribuer au plug-in ; le second argument est le nom 
de la classe qui l'implemente. 

Voici le code d'un fichier .pro permettant de generer le plug-in : 
TEMPLATE = lib 

CONFIG += designer plugin release 
HEADERS = . . /iconeditor/iconeditor. h \ 

iconeditorplugin.h 
SOURCES = .. /iconeditor/iconeditor. cpp \ 

iconeditorplugin . cpp 
RESOURCES = iconeditorplugin. qrc 
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DESTDIR = $(QTDIR) /plugins/designer 

Le fichier . pro suppose que la variable d'environnement QTDIR contient le repertoire ou Qt 
est installe. Quand vous tapez make ou nmake pour generer le plug-in, il s'installera automati- 
quement dans le repertoire plugins du Qt Designer. Une fois le plug-in genere, le widget 
IconEditor peut etre utilise dans le Qt Designer de la meme maniere que n'importe quel 
autre widget integre de Qt. 

Si vous voulez integrer plusieurs widgets personnalises avec le Qt Designer, vous avez la 
possibility soit de creer un plug-in pour chacun d'eux, soit de les combiner dans un seul plug-in en 
derivant QDesignerCustomWidgetCollect ion Interface. 



Double mise en memoire tampon 

La double mise en memoire tampon est une technique de programmation GUI qui consiste a 
afhcher un widget dans un pixmap hors champ puis a copier le pixmap a l'ecran. Avec les 
versions anterieures de Qt, cette technique etait frequemment utilisee pour eliminer le pheno- 
mene du scintillement et pour offrir une interface utilisateur plus confortable. 

Dans Qt4, QWidget gere ce phenomene automatiquement, nous sommes done rarement obli- 
ges de nous soucier du scintillement des widgets. La double mise en memoire tampon explicite 
reste tout de meme avantageuse si le rendu du widget est complexe et doit etre realise de facon 
repetitive. Nous pouvons alors stacker un pixmap de facon permanente avec le widget, 
toujours pret pour le prochain evenement paint , et copier le pixmap dans le widget des que 
nous detectons cet evenement paint. II se revele particulierement utile si nous souhaitons 
effectuer de legeres modifications, comme dessiner un rectangle de selection, sans avoir a 
recalculer a chaque fois le rendu complet du widget. 

Nous allons clore ce chapitre en etudiant le widget personnalise Plotter. Ce widget utilise la 
double mise en memoire tampon et illustre egalement certains aspects de la programmation Qt, 
notamment la gestion des evenements du clavier, la disposition manuelle et les systemes de 
coordonnees. 

Le widget Plotter affiche une ou plusieurs courbes specifiees sous forme de vecteurs de 
coordonnees. Lutilisateur peut tracer un rectangle de selection sur l'image et Plotter 
zoomera sur la zone delimitee par ce trace (voir Figure 5.7). L' utilisateur dessine le rectangle 
en cliquant a un endroit dans le graphique, en faisant glisser la souris vers une autre position en 
maintenant le bouton gauche enfonce puis en relachant le bouton de la souris. 

Lutilisateur peut zoomer de maniere repetee en tracant des rectangles de selection plusieurs 
fois, faire un zoom arriere grace au bouton Zoom Out, puis zoomer a nouveau au moyen du 
bouton Zoom In. Les boutons Zoom In et Zoom Out apparaissent la premiere fois qu'ils 
deviennent accessibles, ils n'encombrent done pas l'ecran si l'utilisateur ne fait pas de zoom 
sur le graphique. 
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Figure 5.7 

Zoomer sur le 
widget Plotter 
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Le widget Plotter peut enregistrer les donnees de nombreuses courbes. II assure aussi la 
maintenance d'une pile d'objets PlotSettings, chacun d'eux correspondant a un niveau 
particulier de zoom. 

Analysons desormais la classe, en commencant par plotter . h : 



#ifndef PL0TTER_H 
#define PLOTTER H 



#include <QMap> 
#include <QPixmap> 
#include <QVector> 
#include <QWidget> 

class QToolButton; 
class PlotSettings; 

class Plotter : public (Midget 
{ 

Q OBJECT 



public: 

Plotter(QWidget 



'parent = 0) 



void setPlotSettingsfconst PlotSettings &settings); 
void setCurveData(int id, const QVector<QPointF> &data); 
void clearCurve(int id); 
QSize minimumSizeHint( ) const; 
QSize sizeHint() const; 

public slots: 
void zoomIn() ; 
void zoomOut() ; 

Nous commencons par inclure les fichiers d'en-tete des classes Qt utilisees dans l'en-tete du 
richier du traceur (plotter) puis nous declarons les classes designees par des pointeurs ou des 
references dans l'en-tete. 
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Dans la classe Plotter, nous fournissons trois fonctions publiques pour configurer le trace et 
deux slots publics pour faire des zooms avant et arriere. Nous reimplementons aussi minimum- 
SizeHint() et sizeHint() dans (Midget. Nous enregistrons les points d'une courbe sous 
forme de QVector<QPointF>, ou QPointF est la version virgule flottante de QPoint. 

protected: 

void paintEventfQPaintEvent *event); 

void resizeEvent(QResizeEvent *event); 

void mousePressEvent(QMouseEvent *event); 

void mouseMoveEvent(QMouseEvent *event); 

void mouseReleaseEvent(QMouseEvent *event); 

void keyPressEvent(QKeyEvent *event); 

void wheelEventfQWheelEvent *event); 

Dans la section protegee de la classe, nous declarons tous les gestionnaires d'evenements de 
QWidget que nous desirons reimplementer. 

private: 

void updateRubberBandRegion() ; 
void ref reshPixmap( ) ; 
void drawGrid(QPainter *painter) ; 
void drawCurvesfQPainter *painter); 

enum { Margin = 50 }; 

QToolButton *zoomInButton; 

QToolButton *zoomOutButton; 

QMap<int, QVector<QPointF> > curveMap; 

QVector<PlotSettings> zoomStack; 

int curZoom; 

bool rubberBandlsShown; 

QRect rubberBandRect; 

QPixmap pixmap; 

}; 

Dans la section privee de la classe, nous declarons quelques fonctions pour dessiner le widget, 
une constante et quelques variables membres. La constante Margin sert a introduire un peu 
d'espace autour du graphique. 

Parmi les variables membres, on compte un pixmap de type QPixmap. Cette variable conserve 
une copie du rendu de tout le widget, identique a celui affiche a l'ecran. Le trace est toujours 
dessine sur ce pixmap d'abord hors champ ; puis le pixmap est copie dans le widget. 

class PlotSettings 
{ 

public: 

PlotSettings () ; 

void scroll(int dx, int dy); 
void adjust () ; 

double spanX() const { return maxX - minX; } 
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double spanY() const { return maxY - minY; } 

double minX; 
double maxX; 
int numXTicks; 
double minY; 
double maxY; 
int numYTicks; 

private: 

static void adjustAxis(double &min, double &max, int &numTicks); 

}; 

#endif 

La classe PlotSettings specifie la plage des axes x et y et le nombre de graduations pour ces 
axes. La Figure 5.8 montre la correspondance entre un objet PlotSettings et un widget 
Plotter. 

Par convention, numXTicks et numYTicks ont une unite de moins ; si numXTicks a la valeur 5, 
Plotter dessinera 6 graduations sur l'axe x. Cela simplifie les calculs par la suite. 



Figure 5.8 

Les variables membres 
de PlotSettings 




Analysons a present le fichier d' implementation : 

#include <QtGui> 
#include <cmath> 

#include "plotter. h" 

Nous incluons les fichiers d'en-tetes prevus et nous importons tous les symboles de l'espace de 
noms std dans l'espace de noms global. Ceci nous permet d'acceder aux fonctions declarees 
dans <cmath> sans les prefixer avec std : : (par exemple, f loor ( ) au lieu de std : : f loor ( )). 

Plotter: :Plotter(QWidget *parent) 
: QWidget( parent) 

{ 

setBackgroundRole(QPalette: :Dark) ; 
setAutoFillBackground(true) ; 

setSizePolicy(QSizePolicy : Expanding, QSizePolicy : Expanding) ; 
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setFocusPolicy (Qt : :StrongFocus) ; 
rubberBandlsShown = false; 

zoomlnButton = new QToolButton(this) ; 
zoomInButton->setIcon(QIcon( " : / images / zoomin .png" ) ) ; 
zoomInButton->adjustSize() ; 

connect(zoomInButton, SIGNAL(clicked( ) ) , this, SL0T(zoomIn( ) ) ) ; 

zoomOutButton = new QToolButton(this) ; 
zoomOutButton->setIcon(QIcon( " : /images/zoomout.png" ) ) ; 
zoomOutButton->adjustSize( ) ; 

connect (zoomOutButton, SIGNAL(clicked( ) ) , this, SL0T(zoom0ut())) ; 
setPlotSettings(PlotSettings() ) ; 

} 

L'appel de setBackgroundRole ( ) demande a QWidget d'utiliser le composant "dark" de la 
palette comme couleur pour effacer le widget, a la place du composant "window". Qt se voit 
done attribuer une couleur par defaut qu'il peut employer pour remplir n'importe quel pixel 
nouvellement affiche quand le widget est redimensionne dans une taille plus grande, avant 
meme que paintEvent() n'ait l'opportunite de dessiner les nouveaux pixels. Nous devons 
aussi invoquer setAutoFillBackground (true) dans le but d'activer ce mecanisme. 
(Par defaut, les widgets enfants heritent de l'arriere-plan de leur widget parent.) 

L'appel de setSizePolicy ( ) definit la strategie de taille du widget en QSizePolicy: : 
Expanding dans les deux directions. Tout gestionnaire de disposition responsable du widget 
sait done que ce dernier peut etre agrandi, mais peut aussi etre retreci. Ce parametre est typique 
des widgets qui peuvent prendre beaucoup de place a l'ecran. La valeur par defaut est QSize- 
Policy : : Preferred dans les deux directions, ce qui signifie que le widget prefere etre a sa 
taille requise, mais qu'il peut etre retreci a sa taille minimale ou agrandi a l'infini si necessaire. 

L'appel de setFocusPolicy (Qt : :StrongFocus) permet au widget de recevoir le focus lorsque 
l'utilisateur clique ou appuie sur Tab. Quand le Plotter est actif, il recevra les evenements 
lies aux touches du clavier enfoncees. Le widget Plotter reagit a quelques touches : + pour 
un zoom avant ; - pour un zoom arriere ; et les fleches directionnelles pour faire defiler vers la 
droite ou la gauche, le haut ou le bas (voir Figure 5.9). 



Figure 5.9 

Faire defiler 
le widget 
Plotter 




Chapitre 5 



Creer des widgets personnalises 127 



Toujours dans le constructeur, nous creons deux QToolButton, chacun avec une icone. Ces 
boutons permettent a l'utilisateur de faire des zooms avant et arriere. Les icones du bouton sont 
stockees dans un fichier de ressources, done toute application qui utilise le widget Plotter 
aura besoin de cette entree dans son fichier .pro : 

RESOURCES = plotter. qrc 

Le fichier de ressources ressemble a celui que nous avons utilise pour 1' application Spreadsheet : 

<!D0CTYPE RCC><RCC version=" 1 .0"> 
<qresource> 

<f ile>images/zoomin . png</f ile> 

<f ile>images/zoomout . png</f ile> 
</qresource> 
</RCC> 

Les appels de ad j ustSize ( ) sur les boutons definissent leurs tailles de sorte qu'elles corres- 
pondent a la taille requise. Les boutons ne font pas partie d'une disposition ; nous les position- 
nerons manuellement dans l'evenement resize de Plotter. Vu que nous ne nous servons pas 
des dispositions, nous devons specifier explicitement le parent des boutons en le transmettant 
au constructeur de QPushButton. 

L'appel de setPlotSettings ( ) a la fin termine l'initialisation. 

void Plotter: :setPlotSettings(const PlotSettings &settings) 
{ 

zoomStack. clear ( ) ; 
zoomStack. append(settings) ; 
curZoom = 0; 
zoomInButton->hide( ) ; 
zoomOutButton->hide( ) ; 
ref reshPixmap( ) ; 

} 

La fonction setPlotSettings ( ) est employee pour specifier le PlotSettings a utiliser 
pour afficher le trace. Elle est appelee par le constructeur Plotter et peut etre employee par 
des utilisateurs de la classe. Le traceur commence a son niveau de zoom par defaut. A chaque 
fois que l'utilisateur fait un zoom avant, une nouvelle instance de PlotSettings est creee et 
placee sur la pile de zoom. La pile de zoom est representee par deux variables membres : 

• zoomStack contient les divers parametres de zoom sous forme de QVector<PlotSet- 
tings>. 

• curZoom comporte l'index du PlotSettings actuel dans zoomStack. 

Apres l'appel de setPlotSettings ( ), la pile de zoom ne contient qu'une seule entree et 
les boutons Zoom In et Zoom Out sont masques. Ces boutons ne s'afficheront que lorsque 
nous appellerons show() sur eux dans les slots zoomIn() et zoomOut(). (Normalement il 
suffit d'invoquer show( ) sur le widget de niveau superieur pour afficher tous les enfants. 
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Mais quand nous appelons explicitement hide ( ) sur un widget enfant, il est masque jusqu'a ce 
nous appelions a nouveau show( ) sur ce widget.) 

L'appel de ref reshPixmap ( ) est necessaire pour mettre a jour l'affichage. Normalement, 
nous invoquerions update ( ) , mais dans ce cas, nous agissons legerement differemment parce 
que nous voulons conserver un QPixmap toujours mis a jour. Apres avoir regenere le pixmap, 
ref reshPixmap ( ) appelle update ( ) pour copier le pixmap dans le widget. 

void Plotter: :zoomOut() 
{ 

if (curZoom > 0) { 
--curZoom; 

zoomOutButton->setEnabled(curZoom > 0); 
zoomInButton->setEnabled(true) ; 
zoomInButton->show( ) ; 
ref reshPixmap ( ) ; 

} 

} 

Le slot zoomOut ( ) fait un zoom arriere si vous avez deja zoome sur le graphique. II decre- 
mente le niveau actuel de zoom et active le bouton Zoom Out selon qu'il est encore possible de 
faire un zoom arriere ou pas. Le bouton Zoom In est active et affiche, et l'affichage est mis a 
jour avec un appel de ref reshPixmap ( ). 

void Plotter: :zoomIn() 
{ 

if (curZoom < zoomStack. count () - 1) { 
++curZoom; 

zoomInButton->setEnabled(curZoom < zoomStack. count() - 1); 
zoomOutButton->setEnabled(true) ; 
zoomOutButton->show( ) ; 
ref reshPixmap( ) ; 

} 

} 

Si l'utilisateur a fait un zoom avant puis un zoom arriere, le PlotSettings du prochain 
niveau de zoom sera dans la pile de zoom et nous pourrons zoomer. (Sinon, il est toujours 
possible de faire un zoom avant avec un rectangle de selection.) 

Le slot incremente curZoom pour descendre d'un niveau dans la pile de zoom, active ou desac- 
tive le bouton Zoom In selon qu'il est possible de faire encore un zoom avant ou non, et active 
et affiche le bouton Zoom Out. A nouveau, nous appelons ref reshPixmap ( ) pour que le traceur 
utilise les derniers parametres du zoom. 

void Plotter: :setCurveData(int id, const QVector<QPointF> &data) 
{ 

curveMap[id] = data; 
ref reshPixmap( ) ; 

} 
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La fonction setCurveData ( ) definit les donnees de courbe pour un ID de courbe donne. S'il 
existe deja une courbe portant le meme ID dans curveMap, elle est remplacee par les nouvelles 
donnees de courbe ; sinon, la nouvelle courbe est simplement inseree. La variable membre 
curveMap est de type QMap<int , QVector<QPointF». 

void Plotter: :clearCurve(int id) 
{ 

curveMap. remove (id) ; 
ref reshPixmap( ) ; 

} 

La fonction clearCurve ( ) supprime la courbe specifiee dans curveMap. 

QSize Plotter: : minimumSizeHint () const 
{ 

return QSize(6 * Margin, 4 * Margin); 

} 

La fonction minimumSizeHint ( ) est similaire a sizeHint ( ) ; tout comme sizeHint ( ) speci- 
fic la taille ideale d'un widget, minimumSizeHint ( ) specifie la taille minimale ideale d'un widget. 
Une disposition ne redimensionne jamais un widget en dessous de sa taille requise minimale. 

La valeur que nous retournons est 300 _ 200 (vu que Margin est egal a 50) pour laisser une 
marge des quatre cotes et un peu d'espace pour le trace. En dessous de cette taille, le trace 
serait trop petit pour etre utile. 

QSize Plotter: :sizeHint( ) const 
{ 

return QSize(12 * Margin, 8 * Margin); 

} 

Dans sizeHint nous retournons une taille "ideale" proportionnelle a la constante Margin et 
avec le meme format d'image de 3:2 que nous avons utilise pour minimumSizeHint ( ). 

Ceci termine l'analyse des slots et des fonctions publiques de Plotter. Etudions a present les 
gestionnaires d'evenements proteges. 

void Plotter: :paintEvent(QPaintEvent * /* event */) 
{ 

QStylePainter painter(this) ; 
painter. drawPixmap(0, 0, pixmap) ; 

if (rubberBandlsShown) { 

painter. setPen( palette ( ) .light ( ) . color ( ) ) ; 
painter.drawRect (rubberBandRect .normalized ( ) 

.adjusted(0, 0, -1, -1)); 

} 

if (hasFocus()) { 

QStyleOptionFocusRect option; 
option. initFrom(this) ; 

option. backgroundColor = palette() .dark() .color() ; 



130 Qt4etC++ : Programmation d'interfaces GUI 



painter. draw/Primitive (QStyle: :PE_FrameFocusRect, option) ; 

} 

} 

Normalement, c'est dans paintEvent ( ) que nous effectuons toutes les operations de dessin. 
Cependant, dans notre exemple, nous avons dessine tout le trace auparavant dans ref resh- 
PixmapO, nous avons done la possibility d'afficher tout le trace simplement en copiant le 
pixmap dans le widget a la position (0, 0). 

Si le rectangle de selection est visible, nous le dessinons au-dessus du trace. Nous utilisons le 
composant "light" du groupe de couleurs actuel du widget comme couleur du crayon pour 
garantir un bon contraste avec l'arriere-plan "dark".Notez que nous dessinons directement sur 
le widget, nous ne touchons done pas au pixmap hors champ. Utiliser QRect : : normalized ( ) 
vous assure que le rectangle de selection presente une largeur et une hauteur positives (en 
changeant les coordonnees si necessaire), et adjusted () reduit la taille du rectangle d'un 
pixel pour tenir compte de son contour d'un pixel. 

Si le Plotter est active, un rectangle "de focus" est dessine au moyen de la fonction draw- 
Primitive ( ) correspondant au style de widget, avec QStyle : : PE_FrameFocusRect comme 
premier argument et QStyleOptionFocusRect comme second argument. Les options graphi- 
ques du rectangle de focus sont heritees du widget Plotter (par l'appel de initFrom( )). La 
couleur d'arriere-plan doit etre specifiee explicitement. 

Si vous voulez dessiner en utilisant le style actuel, vous pouvez appeler directement une fonction 
QStyle, par exemple, 

style ()->drawPrimitive (QStyle: :PE_FrameFocusRect, &option, &painter, 
this) ; 

ou utiliser un QStylePainter au lieu d'un QPainter normal, comme nous avons precede 
dans Plotter. Vous dessinez ainsi plus confortablement. 

La fonction QWidget : : style ( ) retourne le style qui doit etre utilise pour dessiner le widget. 
Dans Qt, le style de widget est une sous-classe de QStyle. Les styles integres englobent QWin- 
dowsStyle, QWindowsXPStyle, QMotif Style, QCDEStyle, QMacStyle et QPlastiqueStyle. 
Chacun de ces styles reimplemente les fonctions virtuelles dans QStyle afin d'adapter le 
dessin a la plate -forme pour laquelle le style est emule. La fonction drawPrimitive ( ) de 
QStylePainter appelle la fonction QStyle du meme nom, qui peut etre employee pour dessiner 
des "elements primitifs" comme les panneaux, les boutons et les rectangles de focus. Le style de 
widget est generalement le meme pour tous les widgets d'une application (QApplica- 
tion : : style ( )), mais vous pouvez 1' adapter au Caspar cas a 1' aide de QWidget : : setStyle( ). 

En derivant QStyle, il est possible de definir un style personnalise. Vous pouvez ainsi attribuer 
un aspect tres particulier a une application ou une suite d' applications. Alors qu'il est habituel- 
lement recommande d'adopter l'aspect et l'apparence natifs de la plate-forme cible, Qt offre 
une grande flexibilite si vous souhaitez intervenir dans ce domaine. 

Les widgets integres de Qt se basent presque exclusivement sur QStyle pour se dessiner. C'est 
pourquoi ils ressemblent aux widgets natifs sur toutes les plates-formes prises en charge par Qt. 
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Les widgets personnalises peuvent adopter le style courant soit en utilisant QStyle pour se 
tracer eux-memes, soit en employant les widgets Qt integres comme widgets enfants. S'agis- 
sant de Plotter, nous utilisons une combinaison des deux approches : le rectangle de focus 
est dessine avec QStyle (via un QStylePainter) et les boutons Zoom In et Zoom Out sont 
des widgets Qt integres. 

void Plotter: :resizeEvent(QResizeEvent * /* event */) 
{ 

int x = width () - (zoomInButton->width() 

+ zoomOutButton->width( ) + 10); 
zoomInButton->move(x, 5); 

zoomOutButton->move(x + zoomInButton->width( ) +5, 5); 
ref reshPixmap( ) ; 

} 

Quand le widget Plotter est redimensionne, Qt declenche un evenement "resize". Ici, nous 
implementons resizeEvent ( ) pour placer les boutons Zoom In et Zoom Out en haut a droite 
du widget Plotter. 

Nous deplacons les boutons Zoom In et Zoom Out pour qu'ils soient cote a cote, separes par un 
espace de 5 pixels et decales de 5 pixels par rapport aux bords superieur et droit du widget parent. 

Si nous avions voulu que les boutons restent ancres dans le coin superieur gauche, dont les 
coordonnees sont (0, 0), nous les aurions simplement places a cet endroit dans le constructeur 
de Plotter. Neanmoins, nous souhaitons assurer le suivi du coin superieur droit, dont les 
coordonnees dependent de la taille du widget. C'est pour cette raison qu'il est necessaire de 
reimplementer resizeEvent() etd'y definir la position des boutons. 

Nous n'avons pas configure les positions des boutons dans le constructeur de Plotter. Ce 
n'est pas un probleme parce que Qt declenche toujours un evenement resize avant d'africher 
un widget pour la premiere fois. 

Plutot que de reimplementer resizeEvent() et de disposer les widgets enfants manuel- 
lement, nous aurions pu faire appel a un gestionnaire de disposition (par exemple, QGri- 
dLayout). L'utilisation d'une disposition aurait ete un peu plus compliquee et aurait 
consomme davantage de ressources, mais les dispositions de droite a gauche aurait ete mieux 
gerees, notamment pour des langues comme l'arabe et l'hebreu. 

Nous terminons en invoquant ref reshPixmap ( ) pour redessiner le pixmap a sa nouvelle taille. 

void Plotter: :mousePressEvent(QMouseEvent *event) 
{ 

QRect rectfMargin, Margin, 

width () - 2 * Margin, height() - 2 * Margin); 

if (event->button() == Qt: :LeftButton) { 
if (rect .contains(event->pos( ) ) ) { 
rubberBandlsShown = true; 
rubberBandRect . setTopLef t (event->pos ( ) ) ; 
rubberBandRect.setBottomRight(event->pos() ) ; 
updateRubberBandRegion( ) ; 
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setCursor(Qt : :CrossCursor) ; 

} 

} 

} 

Quand l'utilisateur appuie sur le bouton gauche de la souris, nous commencons a afficher un 
rectangle de selection. Ceci implique de definir rubberBandlsShown en true, d'initialiser la 
variable membre rubberBandRect a la position actuelle du pointeur de la souris, de planifier 
un evenement paint pour tracer le rectangle et de changer le pointeur de la souris pour afficher 
un pointeur a reticule. 

La variable rubberBandRect est de type QRect. Un QRect peut etre defini soit sous forme 
d'un quadruple (x, y, width, height) -oil (x, y ) est la position du coin superieur gauche 
et width _ height correspond a la taille du rectangle - soit comme une paire de coordonnees 
superieur-gauche et inferieur-droit. Dans ce cas, nous avons employe la representation avec 
des paires de coordonnees. Nous definissons le point ou l'utilisateur a clique a la fois comme 
etant le coin superieur gauche et le coin inferieur droit. Puis nous appelons updateRubber- 
BandRegion ( ) pour forcer le rafraichissement de l'affichage de la (toute petite) zone couverte 
par le rectangle de selection. 

Qt propose deux mecanismes pour controler la forme du pointeur de la souris : 

• QWidget : : setCursor ( ) definit la forme du pointeur a utiliser quand la souris se place sur 
un widget particulier. Si aucun pointeur n'est configure pour le widget, c'est le pointeur du 
widget parent qui est employe. Les widgets de haut niveau proposent par defaut un pointeur 
en forme de fleche. 

• QApplication: :setOverrideCursor() definit la forme du pointeur pour toute l'appli- 
cation, ignorant les pointeurs configures par chaque widget jusqu' a ce que restoreOver ride- 
Cursor () soit invoquee. 

Dans le Chapitre 4, nous avons appele QApplication :: setOverrideCursor ( ) avec 
Qt : :WaitCursor pour changer le pointeur de l'application en sablier. 

void Plotter: :mouseMoveEvent(QMouseEvent *event) 
{ 

if (rubberBandlsShown) { 
updateRubberBandRegionf ) ; 
rubberBandRect . setBottomRight ( event->pos( ) ) ; 
updateRubberBandRegionf ) ; 

} 

} 

Quand l'utilisateur deplace le pointeur de la souris alors qu'il maintient le bouton gauche 
enfonce, nous appelons d'abord updateRubberBandRegion ( ) pour planifier un evenement 
paint afin de redessiner la zone ou se trouvait le rectangle de selection, puis nous recalculons 
rubberBandRect pour tenir compte du deplacement de la souris, et enfin nous invoquons 
updateRubberBandRegion ( ) une deuxieme fois pour retracer la zone vers laquelle s'est 
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deplace le rectangle de selection. Ce rectangle est done effectivement supprime et redessine 
aux nouvelles coordonnees. 

Si l'utilisateur deplace la souris vers le haut ou la gauche, il est probable que le coin inferieur 
droit de rubberBandRect se retrouve au-dessus ou a gauche de son coin superieur gauche. 
Si e'est le cas, QRect aura une largeur ou une hauteur negative. Nous avons utilise 
QRect: : normalized ( ) dans paintEvent() pour nous assurer que les coordonnees supe- 
rieur-gauche et inferieur-droit sont ajustees de maniere a ne pas avoir de largeur et de hauteur 
negatives. 

void Plotter: :mouseReleaseEvent(QMouseEvent *event) 
{ 

if ( (event->button() == Qt: :LeftButton) && rubberBandlsShown) { 
rubberBandlsShown = false; 
updateRubberBandRegion ( ) ; 
unsetCursor( ) ; 

QRect rect = rubberBandRect. normalized ( ) ; 
if (rect.width() < 4 || rect.height() < 4) 
return; 

rect.translate(-Margin, -Margin) ; 

PlotSettings prevSettings = zoomStack[curZoom] ; 
PlotSettings settings; 

double dx = prevSettings. spanX() / (width() - 2 * Margin); 
double dy = prevSettings. spanY)) / (height() - 2 * Margin); 

settings .minX = prevSettings. minX + dx * rect.left)); 
settings. maxX = prevSettings. minX + dx * rect. right)) ; 
settings .minY = prevSettings. maxY - dy * rect. bottom)) ; 
settings .maxY = prevSettings. maxY - dy * rect.top(); 
settings. adjust)) ; 

zoomStack.resize(curZoom + 1); 
zoomStack.append(settings) ; 
zoomln) ) ; 

} 

} 

Quand l'utilisateur relache le bouton gauche de la souris, nous supprimons le rectangle de 
selection et nous restaurons le pointeur standard sous forme de fleche. Si le rectangle est au 
moins de 4X4, nous effectuons un zoom. Si le rectangle de selection est plus petit, il est 
probable que l'utilisateur a clique sur le widget par erreur ou uniquement pour l'activer, nous 
ne faisons done rien. 

Le code permettant de zoomer est quelque peu complexe. C'est parce que nous traitons 
des coordonnees du widget et de celles du traceur en meme temps. La plupart des taches 
effectuees ici servent a convertir le rubberBandRect, pour transformer les coordonnees 
du widget en coordonnees du traceur. Une fois la conversion effectuee, nous invoquons 
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PlotSettings : :adjust() pour arrondir les chiffres et trouver un nombre raisonnable de 
graduations pour chaque axe. Les Figures 5.10 et 5.1 1 illustrent la situation. 



Figure 5.10 (o, o) 

Convertir les coordonnees 
d'un rectangle de 
selection du widget en 
coordonnees du traceur 




Figure 5.11 

Ajuster les coordonnees 
du traceur et zoomer sur 
le rectangle de selection 





Puis nous zoomons. Pour zoomer, nous devons appuyer sur le nouveau PlotSettings que 
nous venons de calculer en haut de la pile de zoom et nous appelons zoomln ( ) qui se chargera 
de la tache. 

void Plotter: : keyPressEvent(QKeyEvent *event) 
{ 

switch (event->key( ) ) { 
case Qt : :Key_Plus: 

zoomln ( ) ; 

break; 
case Qt: :Key_Minus: 

zoomOutf) ; 

break; 
case Qt : :Key_Left : 

zoomStack[curZoom] .scroll(-1 , 0) ; 

ref reshPixmapf ) ; 

break; 
case Qt : :Key_Right : 

zoomStack[curZoom] .scroll(+1 , 0) ; 

ref reshPixmapf ) ; 

break; 
case Qt : :Key_Down : 
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zoomStack[curZoom] .scroll(0, -1 ) ; 

ref reshPixmap( ) ; 

break; 
case Qt : :Key_Up: 

zoomStack[curZoom] .scroll(0, +1 ) ; 

ref reshPixmap( ) ; 

break; 
default : 

QWidget: : keyPressEvent (event) ; 

} 

} 

Quand l'utilisateur appuie sur une touche et que le widget Plotter est actif, la fonction 
keyPressEvent ( ) est invoquee. Nous la reimplementons ici pour repondre a six touches : +, -, 
Haut, Bas, Gauche et Droite. Si l'utilisateur a appuye sur une touche que nous ne gerons pas, 
nous appelons 1' implementation de la classe de base. Pour une question de simplicite, nous 
ignorons les touches de modification Maj, Ctrl et Alt, disponibles via QKeyEvent: :modi- 
f iers( ). 

void Plotter: :wheelEvent(QWheelEvent *event) 
{ 

int numDegrees = event->delta( ) / 8; 
int numTicks = numDegrees / 15; 

if (event->orientation() == Qt : :Horizontal) { 

zoomStack[curZoom] .scroll(numTicks, 0) ; 
} else { 

zoomStack[curZoom] .scroll(0, numTicks) ; 

} 

ref reshPixmap( ) ; 

} 

Les evenements wheel se declenchent quand la molette de la souris est actionnee. La majorite 
des souris ne proposent qu'une molette verticale, mais certaines sont equipees d'une molette 
horizontale. Qt prend en charge les deux types de molette. Les evenements wheel sont trans- 
mis au widget actif. La fonction delta () retourne la distance parcourue par la molette en 
huitiemes de degre. Les souris proposent habituellement une plage de 15 degres. Dans notre 
exemple, nous faisons defiler le nombre de graduations demandees en modifiant 1' element le 
plus haut dans la pile de zoom et nous mettons a jour l'affichage aumoyende ref reshPixmap( ). 

Nous utilisons la molette de la souris le plus souvent pour faire derouler une barre de defilement. 
Quand nous employons QScrollArea (traite dans le Chapitre 6) pour proposer des barres de 
defilement, QScrollArea gere automatiquement les evenements lies a la molette de la souris, 
nous n'avons done pas a reimplementer wheelEvent ( ) nous-memes. 

Ceci acheve 1' implementation des gestionnaires d'evenements. Passons maintenant en revue 
les fonctions privees. 

void Plotter: :updateRubberBandRegion() 
{ 
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QRect rect = rubberBandRect. normalized () ; 
update (rect.left(), rect.top(), rect. width () , 1); 
update(rect.left() , rect.top(), 1, rect.height(j) ; 
update(rect.left(), rect. bottom () , rect .width( ) , 1); 
update(rect.right() , rect.top(), 1, rect . height ( ) ) ; 

} 

La fonction updateRubberBand ( ) est appelee depuis mousePressEvent ( ) , mouseMove- 
Event ( ) et mouseReleaseEvent ( ) pour effacer ou redessiner le rectangle de selection. Elle 
est constitute de quatre appels de update () qui planirient un evenement paint pour les 
quatre petites zones rectangulaires couvertes par le rectangle de selection (deux lignes verti- 
cales et deux lignes horizontales). Qt propose la classe QRubberBand pour dessiner des 
rectangles de selection, mais dans ce cas, l'ecriture du code permet de mieux controler 1' operation. 

void Plotter: : ref reshPixmap( ) 
{ 

pixmap = QPixmap(size( ) ) ; 
pixmap. fill (this, 0, 0); 

QPainter painterf&pixmap) ; 
painter. init From (this) ; 
drawGridf&painter) ; 
drawCurvesf&painter) ; 
update( ) ; 

} 

La fonction ref reshPixmap ( ) redessine le trace sur le pixmap hors champ et met l'affichage 
a jour. Nous redimensionnons le pixmap de sorte qu'il ait la meme taille que le widget et nous 
le remplissons avec la couleur d'effacement du widget. Cette couleur correspond au composant 
"dark" de la palette en raison de l'appel de setBackgroundRole ( ) dans le constructeur de 
Plotter. Si l'arriere-plan n'est pas uni, QPixmap: :fill() doit connaitre la position du 
pixmap dans le widget pour aligner correctement le motif de couleur. Dans notre cas, le pixmap 
correspond a la totalite du widget, nous specifions done la position (0, 0). 

Nous creons ensuite un QPainter pour dessiner sur le pixmap. L'appel de initFrom ( ) definit 
le crayon, l'arriere-plan et la police pour qu'ils soient identiques a ceux du widget Plotter. 
Puis nous invoquons drawGrid() et drawCurves() pour realiser le dessin. Nous appelons 
enfin update ( ) pour planifier un evenement paint pour la totalite du widget. Le pixmap est 
copie dans le widget dans la fonction paintEvent(). 

void Plotter: :drawGrid (QPainter *painter) 
{ 

QRect rect(Margin, Margin, 

width () - 2 * Margin, height() - 2 * Margin); 
if (!rect.isValid()) 
return; 

PlotSettings settings = zoomStack[curZoom] ; 

QPen quiteDark = palettef) .dark() .color() .light() ; 

QPen light = palette() .light () .color() ; 
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for (int i = 0; i <= settings. numXTicks; ++i) { 
int x = rect.left() + (i * (rect. width () - 1) 

/ settings. numXTicks) ; 
double label = settings. minX + (i * settings. spanX() 

/ settings. numXTicks) ; 

painter->setPen(quiteDark) ; 

painter->drawLine(x, rect.topf), x, rect.bottom()) ; 
painter->setPen(light) ; 

painter->drawLine(x, rect. bottom () , x, rect. bottom () +5); 
painter->drawText(x - 50, rect. bottom () + 5, 100, 15, 

Qt: :AlignHCenter | Qt: :AlignTop, 

QString: : number(label) ) ; 

} 

for (int j = 0; j <= settings. numYTicks; ++j) { 
int y = rect. bottom () - (j * (rect. height () - 1) 

/ settings. numYTicks) ; 
double label = settings. minY + (j * settings. spanYf) 

/ settings. numYTicks) ; 

painter->setPen(quiteDark) ; 

painter->drawLine(rect.left() , y, rect.right() , y) ; 
painter->setPen(light) ; 

painter->drawLine(rect.left() - 5, y, rect.left(), y); 
painter->drawText(rect.left() - Margin, y - 10, Margin - 5, 20, 

Qt: :AlignRight | Qt : :AlignVCenter, 

QString: : number(label) ) ; 

} 

painter->drawRect(rect.adjusted(0, 0, -1, -1)); 

} 

La fonction drawGrid() dessine la grille derriere les courbes et les axes. La zone dans 
laquelle nous dessinons la grille est specifiee par rect. Si le widget n'est pas assez grand pour 
s' adapter au graphique, nous retournons immediatement. 

La premiere boucle for trace les lignes verticales de la grille et les graduations sur l'axe x. La 
seconde boucle for trace les lignes horizontales de la grille et les graduations sur l'axe y. A la fin, 
nous dessinons un rectangle le long des marges. La fonction drawText ( ) dessine les numeros 
correspondants aux graduations sur les deux axes. 

Les appels de drawText ( ) ont la syntaxe suivante : 

painter->drawText(x, y, width, height, alignment, text); 

oil (x, y, width, height ) definit un rectangle, alignment la position du texte dans ce 
rectangle et text le texte a dessiner. 

void Plotter: :drawCurves(QPainter *painter) 
{ 

static const QColor colorForIds[6] = { 

Qt::red, Qt:: green, Qt::blue, Qt::cyan, Qt:: magenta, Qt:: yellow 

}; 

PlotSettings settings = zoomStack[curZoom] ; 
QRect rectfMargin, Margin, 

width () - 2 * Margin, height() - 2 * Margin); 
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if (!rect.isValid()) 
return; 

painter->setClipRect(rect.adjusted(+1 , +1, -1, -1)); 

QMapIterator<int, QVector<QPointF> > i(curveMap); 
while (i.hasNext() ) { 
i.next() ; 

int id = i. key ( ) ; 

const QVector<QPointF> &data = i.value(); 
QPolygonF polyline (data. count ( ) ) ; 

for (int j = 0; j < data.count() ; ++j ) { 
double dx = data[j].x() - settings. minX; 
double dy = data[j].y() - settings. minY; 
double x = rect.leftf) + (dx * (rect.widthf) - 1) 

/ settings. spanX() ) ; 
double y = rect. bottom () - (dy * (rect. height () - 1) 

/ settings. spanY() ) ; 

polyline!]] = QPointF(x, y); 

} 

painter->setPen(colorForIds[uint(id) % 6] ) ; 
painter->drawPolyline( polyline) ; 

} 

} 

La fonction drawCurves( ) dessine les courbes au-dessus de la grille. Nous commencons par 
appeler setClipRect ( ) pour definir la zone d'action de QPainter comme egale au rectangle 
qui contient les courbes (excepte les marges et le cadre autour du graphique). QPainter igno- 
rera ensuite les operations de dessin sur les pixels situes en dehors de cette zone. 

Puis, nous parcourons toutes les courbes a l'aide d'un iterateur de style Java, et pour chacune 
d'elles, nous parcourons les QPointF dont elle est constitute. La fonction key ( ) donne l'ID 
de la courbe et la fonction value ( ) donne les donnees de courbe correspondantes comme un 
QVector<QPointF>. La boucle interne for convertit chaque QPointF pour transformer les 
coordonnees du traceur en coordonnees du widget et les stocke dans la variable polyline. 

Une fois que nous avons converti tous les points d'une courbe en coordonnees du widget, nous 
determinons la couleur de crayon pour la courbe (en utilisant un des ensembles de couleurs 
predefinies) et nous appelons drawPolyline ( ) pour tracer une ligne qui passe par tous les 
points de cette derniere. 

Voici la classe Plotter terminee. Tout ce qui reste, ce sont quelques fonctions dans Plot- 
Settings. 

PlotSettings: :PlotSettings() 
{ 

minX =0.0; 
maxX = 10.0; 
numXTicks = 5; 
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minY =0.0; 
maxY = 10.0; 
numYTicks = 5; 

} 

Le constructeur de PlotSettings initialise les deux axes avec une plage de 0 a 10 en 
5 graduations. 

void PlotSettings: :scroll(int dx, int dy) 
{ 

double stepX = spanXf) / numXTicks; 
minX += dx * stepX; 
maxX += dx * stepX; 

double stepY = spanY() / numYTicks; 
minY += dy * stepY; 
maxY += dy * stepY; 

} 

La fonction scroll ( ) incremente (ou decremente) minX, maxX, minY et maxY de la valeur de 
l'intervalle entre deux graduations multipliee par un nombre donne. Cette fonction est utilisee 
pour implementer le defilement dans Plotter: : keyPressEvent ( ). 

void PlotSettings: :adjust() 
{ 

adjustAxisfminX, maxX, numXTicks); 
adj ustAxis (minY, maxY, numYTicks); 

} 

La fonction adjust() est invoquee dans mouseReleaseEvent() pour arrondir les valeurs 
minX, maxX, minY et maxY en valeurs "conviviales" et pour determiner le bon nombre de 
graduations pour chaque axe. La fonction privee ad j ustAxis ( ) s'execute sur un axe a la fois. 

void PlotSettings: : ad j ustAxis (double &min, double &max, 

int &numTicks) 

{ 

const int MinTicks = 4; 

double grossStep = (max - min) / MinTicks; 

double step = pow(10.0, f loor(log10(grossStep) ) ) ; 

if (5 * step < grossStep) { 

step *= 5; 
} else if (2 * step < grossStep) { 
step *= 2; 
} 

numTicks = int(ceil(max / step) - floor(min / step)); 
if (numTicks < MinTicks) 
numTicks = MinTicks; 
min = floor(min / step) * step; 
max = ceilfmax / step) * step; 

} 
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La fonction adj ustAxis ( ) convertit ses parametres min et max en nombres "conviviaux" et 
definit son parametre numTicks en nombre de graduations qu'elle calcule comme etant appro- 
priees pour la plage [min, max] donnee. Vu que ad] ustAxis ( ) a besoin de modifier les 
variables reelles (minX, maxX, numXTicks, etc.) et pas uniquement des copies, ses parametres 
sont des references non-const. 

Le code de ad j ustAxis ( ) est principalement consacre a determiner une valeur adequate pour 
l'intervalle entre deux graduations ("l'echelon"). Pour obtenir des nombres convenables sur 
l'axe, nous devons selectionner l'echelon avec soin. Par exemple, une valeur de 3,8 engendre- 
rait des multiples de 3,8 sur un axe, ce qui n'est pas tres significatif pour les utilisateurs. Pour 
les axes avec une notation decimale, des valeurs d' echelons "conviviales" sont des chiffres de 
la forme 10 n , 2 x 10 n ou 5 x 10". 

Nous commencons par calculer "l'echelon brut," une sorte de valeur maximum pour l'echelon. 
Puis nous recherchons le nombre correspondant sous la forme 10" qui est inferieur ou egal a 
l'echelon brut. Pour ce faire, nous prenons le logarithme decimal de l'echelon brut, en 
arrondissant cette valeur vers le bas pour obtenir un nombre entier, puis en ajoutant 10 a la 
puissance de ce chiffre arrondi. Par exemple, si l'echelon brut est de 236, nous calculons log 
236 = 2,37291... ; puis nous l'arrondissons vers le bas pour aboutir a 2 et nous obtenons 
10 2 = 100 comme valeur d'echelon sous la forme 10". 

Une fois que la premiere valeur d'echelon est determinee, nous pouvons l'utiliser pour calculer 
les deux autres candidats : 2 x 10" et 5 x 10". Dans l'exemple ci-dessus, les deux autres candi- 
dats sont 200 et 500. Le candidat 500 est superieur a l'echelon brut, nous n'avons done pas la 
possibility de l'employer. Mais 200 est inferieur a 236, nous utilisons ainsi 200 comme taille 
d'echelon dans cet exemple. 

II est assez facile de calculer numTicks, min et max a partir de la valeur d'echelon. La nouvelle 
valeur min est obtenue en arrondissant la valeur min d'origine vers le bas vers le multiple le plus 
proche de l'echelon, et la nouvelle valeur max est obtenue en arrondissant vers le haut vers le multi- 
ple le plus proche de l'echelon. La nouvelle valeur numTicks correspond au nombre d'inter- 
valles entre les valeurs min et max arrondies. Par exemple, si min est egal a 240 et max a 1184 
au moment de la saisie de la fonction, la nouvelle plage devient [200, 1200], avec cinq graduations. 

Cet algorithme donnera des resultats optimaux dans certains cas. Un algorithme plus sophisti- 
que est decrit dans l'article "Nice Numbers for Graph Labels" de Paul S. Heckbert publie dans 
Graphics Gems (ISBN 0-12-286166-3). 

Ce chapitre acheve la Partie I. II vous a explique comment personnaliser un widget Qt existant 
et comment generer un widget en partant de zero a l'aide de QWidget comme classe de base. 
Nous avons aussi vu comment composer un widget a partir de widgets existants dans le Chapi- 
tre 2 et nous allons explorer ce theme plus en detail dans le Chapitre 6. 

A ce stade, vous en savez suffisamment pour ecrire des applications GUI completes avec Qt. 
Dans les Parties II et III, nous etudierons Qt en profondeur pour pouvoir profiter de toute la 
puissance de ce framework. 
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Chaque widget place dans un formulaire doit se voir attribuer une taille et une position 
appropriees. Qt propose plusieurs classes qui disposent les widgets dans un formulaire : 
QHBoxLayout, QVBoxLayout, QGridLayout et QStackLayout. Ces classes sont si 
pratiques et faciles a utiliser que presque tous les developpeurs Qt s'en servent, soit 
directement dans du code source, soit par le biais du Qt Designer. 

II existe une autre raison d'employer les classes de disposition (layout) de Qt : elles 
garantissent que les formulaires s'adaptent automatiquement aux diverses polices, 
langues et plates-formes. Si l'utilisateur modifie les parametres de police du systeme, 
les formulaires de 1' application repondront immediatement en se redimensionnant eux- 
memes si necessaire. Si vous traduisez l'interface utilisateur de l'application en d'autres 
langues, les classes de disposition prennent en compte le contenu traduit des widgets 
pour eviter toute coupure de texte. 
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QSplitter, QScrollArea, QMainWindow et QWorkspace sont d'autres classes qui se char- 
gent de gerer la disposition. Le point commun de ces classes c'est qu'elles procurent une 
disposition tres flexible sur laquelle l'utilisateur peut agir. Par exemple, QSplitter propose un 
separateur que Tutilisateur peut faire glisser pour redimensionner les widgets, et QWorkspace 
prend en charge MDI (multiple document interface), un moyen d'afficher plusieurs documents 
simultanement dans la fenetre principale d'une application. Etant donne qu'elles sont souvent 
utilisees comme des alternatives aux classes de disposition, elles sont aussi presentees dans ce 
chapitre. 



Disposer des widgets sur un formulaire 

II y a trois moyens de gerer la disposition des widgets enfants dans un formulaire : le position- 
nement absolu, la disposition manuelle et les gestionnaires de disposition. Nous allons etudier 
chacun d'eux a tour de role, en nous basant sur la boite de dialogue Find File illustree en 
Figure 6.1. 



Figure 6.1 

La boite de dialogue 
Find File 



a e 



Find Files or Folders 
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Le positionnement absolu est le moyen le plus rudimentaire de disposer des widgets. II suffit 
d'assigner dans du code des tailles et des positions aux widgets enfants du formulaire et une 
taille fixe au formulaire. Voici a quoi ressemble le constructeur de FindFileDialog avec le 
positionnement absolu : 

FindFileDialog: : FindFileDialog (QWidget *parent) 
: QDialog(parent) 

{ 

namedLabel->setGeometry(9, 9, 50, 25); 
namedLineEdit->setGeometry(65, 9, 200, 25); 
lookInLabel->setGeometry(9, 40, 50, 25); 
lookInLineEdit->setGeometry(65, 40, 200, 25); 
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subfoldersCheckBox->setGeometry(9, 71, 256, 23); 
tableWidget->setGeometry(9, 100, 256, 100); 
messageLabel->setGeometry(9, 206, 256, 25); 
findButton->setGeometry(271 , 9, 85, 32); 
stopButton->setGeometry(271 , 47, 85, 32); 
closeButton->setGeometry(271 , 84, 85, 32); 
helpButton->setGeometry(271 , 199, 85, 32); 

setWindowTitle(tr( "Find Files on Folders")); 
setFixedSize(365, 240); 

} 

Le positionnement absolu presente de nombreux inconvenients : 

• L'utilisateur ne peut pas redimensionner la fenetre. 

• Une partie du texte peut etre coupee si l'utilisateur choisit une police trop grande ou si 
1' application est traduite dans une autre langue. 

• Les widgets peuvent presenter des tailles inadaptees pour certains styles. 

• Les positions et les tailles doivent etre calculees manuellement. Cette methode est fasti- 
dieuse et sujette aux erreurs ; de plus, elle complique la maintenance. 

L' alternative au positionnement absolu est la disposition manuelle. Avec cette technique, les 
widgets ont toujours des positions absolues donnees, mais leurs tailles sont proportionnelles a 
la taille de la fenetre au lieu d'etre totalement codees. II convient done de reimplementer la 
fonction resizeEvent() du formulaire pour definir les geometries de ses widgets enfants : 

FindFileDialog : :FindFileDialog(QWidget *parent) 
: QDialog(parent) 

{ 

setMinimumSize(265, 190); 
resize(365, 240); 

} 

void FindFileDialog: : resizeEvent(QResizeEvent * /* event */) 
{ 

int extraWidth = width () - minimumWidth( ) ; 
int extraHeight = height() - minimumHeightf) ; 

namedLabel->setGeometry(9, 9, 50, 25); 
namedLineEdit->setGeometry(65, 9, 100 + extraWidth, 25); 
lookInLabel->setGeometry(9, 40, 50, 25); 
lookInLineEdit->setGeometry(65, 40, 100 + extraWidth, 25); 
subfoldersCheckBox->setGeometry(9, 71, 156 + extraWidth, 23); 

tableWidget->setGeometry(9, 100, 156 + extraWidth, 

50 + extraHeight) ; 
messageLabel->setGeometry (9, 156 + extraHeight, 156 + extraWidth, 

25); 

findButton->setGeometry(171 + extraWidth, 9, 85, 32); 
stopButton->setGeometry(171 + extraWidth, 47, 85, 32); 
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closeButton->setGeometry(171 + extraWidth, 84, 85, 32); 
helpButton->setGeometry(171 + extraWidth, 149 + extraHeight, 85, 

32); 

} 

Dans le constructeur de FindFileDialog, nous configurons la taille minimale du formulaire 
en 265 X 190 et la taille initiale en 365 X 240. Dans le gestionnaire resizeEvent ( ), nous 
accordons de l'espace supplementaire aux widgets qui veulent s'agrandir. Nous sommes ainsi 
certains que le formulaire se met a l'echelle quand Tutilisateur le redimensionne, comme illustre 
en Figure 6.2. 
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Figure 6.2 

Redimensionner une boite de dialogue redimensionnable 



Tout comme le positionnement absolu, la disposition manuelle oblige le programmeur a calculer 
beaucoup de constantes codees. Ecrire du code de cette maniere se revele penible, notamment 
si la conception change. De plus, le texte court toujours le risque d'etre coupe. Nous pouvons 
eviter ce probleme en tenant compte des tailles requises des widgets enfants, mais cela compli- 
querait encore plus le code. 

La solution la plus pratique pour disposer des widgets sur un formulaire consiste a utiliser les 
gestionnaires de disposition de Qt. Ces gestionnaires proposent des valeurs par defaut raison- 
nables pour chaque type de widget et tiennent compte de la taille requise de chacun d'eux, qui 
depend de la police, du style et du contenu du widget. Ces gestionnaires respectent egalement 
des dimensions minimales et maximales, et ajustent automatiquement la disposition en 
reponse a des changements de police ou de contenu et a un redimensionnement de la fenetre. 

Les trois gestionnaires de disposition les plus importants sont QHBoxLayout, QVBoxLayout et 
QGridLayout. Ces classes heritent de QLayout, qui fournit le cadre de base des dispositions. 
Ces trois classes sont totalement prises en charge par le Qt Designer et peuvent aussi etre utilisees 
directement dans du code. 

Voici le code de FindFileDialog avec des gestionnaires de disposition : 
FindFileDialog: : FindFileDialog (QWidget *parent) 
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: QDialog(parent) 

{ 

QGridLayout *leftLayout = new QGridLayout; 
leftLayout->addWidget(namedLabel, 0, O); 
leftLayout->addWidget(namedLineEdit, 0, 1); 
leftLayout->addWidget(lookInLabel, 1,0); 
leftLayout->addWidget(lookInLineEdit, 1, 1); 
leftLayout->addWidget(subfoldersCheckBox, 2, 0, 1, 2); 
leftLayout->addWidget(tableWidget, 3, 0, 1, 2); 
leftLayout->addWidget(messageLabel, 4, 0, 1, 2); 

QVBoxLayout *rightLayout = new QVBoxLayout; 
rightLayout->addWidget (f indButton) ; 
rightLayout->addWidget (stopButton) ; 
rightLayout->addWidget (closeButton) ; 
rightLayout->addStretch( ) ; 
rightLayout->addWidget (helpButton) ; 

QHBoxLayout *mainLayout = new QHBoxLayout; 
mainLayout->addLayout (leftLayout) ; 
mainLayout->addLayout ( rightLayout ) ; 
setLayout(mainLayout) ; 

setWindowTitle(tr( "Find Files on Folders")); 

} 

La disposition est geree par QHBoxLayout, QGridLayout et QVBoxLayout. QGridLayout a 
gauche et QVBoxLayout a droite sont places cote a cote par le QHBoxLayout externe. Les 
marges autour de la boite de dialogue et l'espace entre les widgets enfants presentent des 
valeurs par defaut en fonction du style de widget ; elles peuvent etre modifiees grace a 
QLayout: : setMargin ( ) etQLayout: : setSpacing ( ). 

La meme boite de dialogue aurait pu etre creee visuellement dans le Qt Designer en placant les 
widgets enfants a leurs positions approximatives, en selectionnant ceux qui doivent etre dispo- 
ses ensemble et en cliquant sur Form > Lay Out Horizontally, Form > Lay Out Vertically ou 
Form > Lay Out in a Grid. Nous avons employe cette approche dans le Chapitre 2 pour creer 
les boites de dialogue Go-to-Cell et Sort de 1' application Spreadsheet. 

Utiliser QHBoxLayout et QVBoxLayout est plutot simple mais l'utilisation de QGridLayout se 
revele un peu plus complexe. QGridLayout se base sur une grille de cellules a deux dimen- 
sions. Le QLabel dans le coin superieur gauche de la disposition se trouve a la position (0, 0) 
et le QLineEdit correspondant se situe a la position (0, 1). Le QCheckBox s'etend sur deux 
colonnes ; il occupe les cellules aux positions (2, 0) et (2, 1). Les QTreeWidget et QLabel en 
dessous prennent aussi deux colonnes (voir Figure 6.3). Les appels de addWidget ( ) ont la 
syntaxe suivante : 

layout->addWidget (widget, row, column, rowSpan, columnSpan); 



148 Qt4etC++ : Programmation d'interfaces GUI 



Figure 6.3 
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Dans ce cas, widget est le widget enfant a inserer dans la disposition, ( row, column ) est la 
cellule en haut a gauche occupee par le widget, rowSpan correspond au nombre de lignes 
occupees par le widget et columnSpan est le nombre de colonnes occupees par le widget. 
S'ils sont omis, les parametres rowSpan et columnSpan ont la valeur 1 par defaut. 

L'appel de addStretch() ordonne au gestionnaire de disposition d'utiliser l'espace a cet 
endroit dans la disposition. En ajoutant un element d'etirement, nous avons demande au 
gestionnaire de disposition de placer tout espace excedentaire entre les boutons Close et Help. 
Dans le Qt Designer, nous pouvons aboutir au meme effet en inserant un element d'espacement. 
Les elements d'espacement apparaissent dans le Qt Designer sous forme de "ressorts" bleus. 

Utiliser des gestionnaires de disposition presente des avantages supplementaires par rapport a 
ceux decrits jusque la. Si nous ajoutons ou supprimons un widget dans une disposition, celle-ci 
s'adaptera automatiquement a la nouvelle situation. II en va de meme si nous invoquons hide ( ) 
ou show( ) sur un widget enfant. Si la taille requise d'un widget enfant change, la disposition 
sera automatiquement corrigee, en tenant compte de cette nouvelle taille. En outre, les gestion- 
naires de disposition definissent automatiquement une taille minimale pour le formulaire, en 
fonction des tailles minimales et des tailles requises des widgets enfants de ce dernier. 

Dans les exemples donnes jusqu'a present, nous avons simplement place les widgets dans des 
dispositions et utilise des elements d'espacement pour combler tout espace excedentaire. Dans 
certains cas, ce n'est pas suffisant pour que la disposition ressemble exactement a ce que nous 
voulons. Nous pouvons done ajuster la disposition en changeant les strategies de taille (regies 
auxquelles la taille est soumise, voir chapitre precedent) et les tailles requises des widgets a 
disposer. 

Grace a la strategie de taille d'un widget, le systeme de disposition sait comment ce widget 
doit etre etire ou retreci. Qt propose des strategies par defaut raisonnables pour tous ses 
widgets integres. Cependant, puisqu'il n'existe pas de valeur par defaut qui pourrait tenir 
compte de toutes les dispositions possibles, il est courant que les developpeurs modifient les 
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strategies pour un ou deux widgets dans un formulaire. Un QSizePolicy possede un composant 
horizontal et un vertical. Voici les valeurs les plus utiles : 

• Fixed signifie que le widget ne peut pas etre retreci ou etire. Le widget conserve toujours 
sa taille requise. 

• Minimum signifie que la taille requise d'un widget correspond a sa taille minimale. Le 
widget ne peut pas etre retreci en dessous de la taille requise, mais il peut s'agrandir pour 
combler l'espace disponible si necessaire. 

• Maximum signifie que la taille requise d'un widget correspond a sa taille maximale. Le widget 
peut etre retreci jusqu' a sa taille requise minimum. 

• Preferred signifie que la taille requise d'un widget correspond a sa taille favorite, mais 
que le widget peut toujours etre retreci ou etire si necessaire. 

Expanding signifie que le widget peut etre retreci ou etire, mais qu'il prefere etre agrandi. 

La Figure 6.4 recapitule la signification des differentes strategies, en utilisant un QLabel affichant 
le texte "Some Text" comme exemple. 



Figure 6.4 

La signification des diffe- 
rentes strategies de taille 



taille requise min 



Fixed 



Minimum 
Maximum 
Preferred 



Som 



Som 



Expanding Som 



taille requise 

K H 



SomeText 



SomeText 



SomeText 



SomeText 



SomeText 



SomeText 



SomeText 



SomeText 



Dans la figure, Preferred et Expanding donnent le meme resultat. Ou se situe la difference ? 
Quand un formulaire qui contient les widgets Preferred et Expanding est redimensionne, 
l'espace supplementaire est attribue aux widgets Expanding, alors que les widgets Preferred 
conservent leur taille requise. 

II existe deux autres strategies : MinimumExpanding et Ignored. La premiere etait necessaire 
dans quelques rares cas dans les versions anterieures de Qt, mais elle ne presente plus d'inte- 
ret ; la meilleure approche consiste a utiliser Expanding et a reimplementer minimum- 
SizeHint( ) de facon appropriee. La seconde est similaire a Expanding, sauf qu'elle ignore 
la taille requise et la taille requise minimum du widget. 

En plus des composants verticaux et horizontaux de la strategic, la classe QSizePolicy stocke 
un facteur d'etirement horizontal et vertical. Ces facteurs d'etirement peuvent etre utilises pour 
indiquer que les divers widgets enfants doivent s'etirer a differents niveaux quand le formulaire 
s'agrandit. Par exemple, si nous avons un QTreeWidget au-dessus d'un QTextEdit et que 
nous voulons que le QTextEdit soit deux fois plus grand que le QTreeWidget, nous avons la 
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possibility de definir un facteur d'etirement vertical de QTextEdit de 2 et un facteur d'etirement 
vertical de QTreeWidget de 1. 

Cependant, un autre moyen d'influencer une disposition consiste a configurer une taille mini- 
male ou maximale, ou une taille fixe pour les widgets enfants. Le gestionnaire de disposition 
respectera ces contraintes lorsqu'il disposera les widgets. Et si ce n'est pas suffisant, nous 
pouvons toujours deriver de la classe du widget enfant et reimplementer sizeHint() pour 
obtenir la taille requise dont nous avons besoin. 



Dispositions empilees 



La classe QStackedLayout dispose un ensemble de widgets enfants, ou "pages," et n'en affi- 
che qu'un seul a la fois, en masquant les autres a l'utilisateur. QStackedLayout est invisible 
en soi et l'utilisateur n'a aucun moyen de changer une page. Les petites fleches et le cadre gris 
fonce dans la Figure 6.5 sont fournis par le Qt Designer pour faciliter la conception avec la 
disposition. Pour des questions pratiques, Qt inclut egalement un QStackedWidget qui 
propose un QWidget avec un QStackedLayout integre. 



Figure 6.5 
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La boite de dialogue Preferences illustree en Figure 6.6 est un exemple qui utilise QStacke- 
dLayout. Elle est constitute d'un QListWidget a gauche et d'un QStackedLayout a droite. 
Chaque element dans QListWidget correspond a une page differente dans QStackedLayout. 
Voici le code du constructeur de la boite de dialogue : 

PreferenceDialog: :PreferenceDialog(QWidget *parent) 
: QDialog(parent) 

{ 

listWidget = new QListWidget; 
listWidget->addItem(tr( "Appearance" ) ) ; 
listWidget->addItem(tr( "Web Browser" ) ) ; 
listWidget->addItem(tr( "Mail & News")); 
listWidget->addItem(tr( "Advanced" ) ) ; 

stackedLayout = new QStackedLayout; 
stackedLayout->addWidget(appearancePage) ; 
stackedLayout->addWidget(webBrowserPage) ; 
stackedLayout ->addWidget(mailAndNewsPage) ; 
stackedLayout->addWidget(advancedPage) ; 
connect(listWidget, SIGNALfcurrentRowChanged(int) ) , 
stackedLayout, SLOT(setCurrentIndex(int) ) ) ; 

listWidget->setCurrentRow(0) ; 

} 

Nous creons un QListWidget et nous l'alimentons avec les noms des pages. Nous creons 
ensuite un QStackedLayout et nous invoquons addWidget() pour chaque page. Nous 
connectons le signal currentRowChanged ( int ) du widget liste a setCurrentlndex(int) 
de la disposition empilee pour implementer le changement de page, puis nous appelons 
setCurrentRow( ) sur le widget liste a la fin du constructeur pour commencer a la page 0. 

Ce genre de formulaire est aussi tres facile a creer avec le Qt Designer : 

1. creez un nouveau formulaire en vous basant sur les modeles "Dialog" ou "Widget" ; 

2. ajoutez un QListWidget et un QStackedWidget au formulaire ; 

3. remplissez chaque page avec des widgets enfants et des dispositions ; 

(Pour creer une nouvelle page, cliquez du bouton droit et selectionnez Insert Page ; pour 
changer de page, cliquez sur la petite fleche gauche ou droite situee en haut a droite du 
QStackedWidget) 

4. disposez les widgets cote a cote grace a une disposition horizontale ; 

5. connectez le signal currentRowChanged ( int ) du widget liste au slot setCurrent- 
Index ( int) du widget empile ; 

6. definissez la valeur de la propriete currentRow du widget liste en 0. 

Etant donne que nous avons implemente le changement de page en utilisant des signaux et des 
slots predefinis, la boite de dialogue presentera le bon comportement quand elle sera previsua- 
lisee dans le Qt Designer. 
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Separateurs 

QSplitter est un widget qui comporte d'autres widgets. Les widgets dans un separateur sont 
separes par des poignees. Les utilisateurs peuvent changer les tailles des widgets enfants du 
separateur en faisant glisser ces poignees. Les separateurs peuvent souvent etre utilises comme 
une alternative aux gestionnaires de disposition, pour accorder davantage de controle a l'utili- 
sateur. 



Figure 6.7 

L' application 
Splitter 



Mon enfant, ma soeur, 
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to love and to die 
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dort hin(unter) zu gehen urn zusammen 
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Zu lieben und zu sterben 

in dem Land, das dir gleicht. 



Les widgets enfants d'un QSplitter sont automatiquement places cote a cote (ou un en- 
dessous de l'autre) dans l'ordre dans lequel ils sont crees, avec des barres de separation entre 
les widgets adjacents. Voici le code permettant de creer la fenetre illustree en Figure 6.7 : 

int mainfint argc, char *argv[]) 
{ 

QApplication appfargc, argv); 

QTextEdit *editor1 = new QTextEdit; 
QTextEdit *editor2 = new QTextEdit; 
QTextEdit *editor3 = new QTextEdit; 

QSplitter splitter(Qt: :Horizontal) ; 
splitter. addWidget(editor1 ) ; 
splitter. addWidget(editor2) ; 
splitter. addWidget(editor3) ; 

splitter. show() ; 
return app.exec() ; 

} 

L'exemple est constitue de trois QTextEdit disposes horizontalement par un widget QSplitter. 
Contrairement aux gestionnaires de disposition qui se contentent d'organiser les widgets 
enfants d'un formulaire et ne proposent aucune representation visuelle, QSplitter herite de 
QWidget et peut etre utilise comme n'importe quel autre widget. 

Vous obtenez des dispositions complexes en imbriquant des QSplitter horizontaux et verti- 
caux. Par exemple, l'application Mail Client presentee en Figure 6.9 consiste en un QSplitter 
horizontal qui contient un QSplitter vertical sur sa droite. 
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Figure 6.8 
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Figure 6.9 

L 'application 
Mail Client 
sous Mac OS X 




Message Settings Help 



Subject 



Happy New Year! 



Sender 



Date 



Grace K <grace@software-inc.com> 2006-12-31 



Radically new concept! Grace K. <grace@software-inc.com> 2006-12-22 
Accounts pascale@nospam.com 2006-12-31 

Expenses Joe Bloggs <joe@bloggs.com> 2006-12-25 

Re: Expenses Andy <andy@nospam.cam> 2007-01-02 

Re: Accounts Joe Bloggs <joe@bloggs com> 2007-01-03 [T 

Subject: Happy New Year! 
Date:Sun, 31 Dec 2006 
From: Grace K, <grace@software-inc.com> 
To: all@software-inc.com 

I want to seize this occasion to thank everybody for the year that has gone, and 
want to wish you the best for next year. It has been a pleasure to work with you 
on the Hawk project, and I'm sure we'll get concrete results shortly. 

Happy New Year! 
--Grace 



No new messages on server 



Voici le code dans le constructeur de la sous-classe QMainWindowde l'application Mail Client : 

MailClient: :MailClient() 
{ 

rightSplitter = new QSplitter (Qt: : Vertical) ; 
rightSplitter->addWidget(messagesTreeWidget) ; 
rightSplitter->addWidget(textEdit) ; 
rightSplitter->setStretchFactor(1 , 1 ) ; 

mainSplitter = new QSplitter(Qt: :Horizontal) ; 
mainSplitter->addWidget (foldersTreeWidget) ; 
mainSplitter->addWidget (rightSplitter) ; 
mainSplitter->setStretchFactor(1 , 1 ) ; 
setCentralWidget (mainSplitter) ; 

setWindowTitle(tr( "Mail Client") ) ; 
readSettingsf ) ; 

} 

Apres avoir cree les trois widgets que nous voulons afficher, nous creons un separateur verti- 
cal, rightSplitter, et nous ajoutons les deux widgets dont nous avons besoin sur la droite. 
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Nous creons ensuite un separateur horizontal, mainSplitter, et nous ajoutons le widget que 
nous voulons qu'il affiche sur la gauche. Nous creons aussi rightSplitter dont les widgets 
doivent s'afficher a droite. mainSplitter devient le widget central de QMainWindow. 

Quand l'utilisateur redimensionne une fenetre, QSplitter distribue normalement l'espace de 
sorte que les tailles relatives des widgets enfants restent les memes. Dans l'exemple Mail 
Client, nous ne souhaitons pas ce comportement ; nous voulons plutot que QTreeWidget et 
QTableWidget conservent leurs dimensions et nous voulons attribuer tout espace supplemen- 
taire a QTextEdit (voir Figure 6.10). Nous y parvenons grace aux deux appels de setStretch- 
Factor ( ) . Le premier argument est l'index de base zero du widget enfant du separateur et le 
second argument est le facteur d'etirement que nous desirons definir ; la valeur par defaut est 
egale a 0. 



Figure 6.10 
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Le premier appel de setStretchFactor( ) est effectue sur rightSplitter et derinit le 
widget a la position 1 (textEdit) pour avoir un facteur d'etirement de 1. Le deuxieme appel 
de setStretchFactor ( ) se fait sur mainSplitter et fixe le widget a la position 1 (right- 
Splitter) pour obtenir un facteur d'etirement de 1. Ceci garantit que tout espace supplemen- 
taire disponible reviendra a textEdit. 

Quand l'application est lancee, QSplitter attribue aux widgets enfants des tailles appropriees 
en fonction de leurs dimensions initiales (ou en fonction de leur taille requise si la dimension 
initiale n'est pas specifiee). Nous pouvons gerer le deplacement des poignees du separateur 
dans le code en appelant QSplitter : : setSizes ( ). La classe QSplitter procure egalement 
un moyen de sauvegarder et restaurer son etat la prochaine fois que l'application est executee. 
Voici la fonction writeSettings ( ) qui enregistre les parametres de Mail Client : 

void MailClient: :writeSettings() 
{ 

QSettings settings( "Software Inc.", "Mail Client"); 

settings. beginGroup( "mainWindow" ) ; 
settings. setValue( "size" , size( ) ) ; 

settings. setValue( "mainSplitter" , mainSplitter->saveState() ) ; 
settings. setValue( "rightSplitter" , rightSplitter->saveState( ) ) ; 
settings. endGroup() ; 

} 
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Voila la fonction readSettings ( ) correspondante : 

void MailClient: : readSettings () 
{ 

QSettings settings( "Software Inc.", "Mail Client"); 
settings. beginGroup( "mainWindow" ) ; 

resize(settings.value( "size" , QSize(480, 360) ) .toSize() ) ; 
mainSplitter->restoreState ( 

settings. value ( "mainSplitter" ) .toByteArray ( ) ) ; 
rightSplitter->restoreState( 

settings. value ( "rightSplitter" ) .toByteArray ( ) ) ; 
settings. endGroup() ; 

} 

QSp litter est totalement pris en charge par le Qt Designer. Pour placer des widgets dans un 
separateur, positionnez les widgets enfants plus ou moins a leurs emplacements, selectionnez-les 
et cliquez sur Form > Lay Out Horizontally in Splitter ou Form > Lay Out Vertically in Splitter. 

Zones deroulantes 

La classe QScrollArea propose une fenetre d'affichage deroulante et deux barres de defile- 
ment, comme le montre la Figure 6.1 1. Si vous voulez ajouter des barres de defilement a un 
widget, le plus simple est d'utiliser un QScrollArea au lieu d'instancier vos propres 
QScrollBar et d'implementer la fonctionnalite deroulante vous-meme. 



Figure 6.11 
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Pour se servir de QScrollArea, il faut appeler setWidget() avec le widget auquel vous 
souhaitez ajouter des barres de defilement. QScrollArea reparente automatiquement le 
widget pour qu'il devienne un enfant de la fenetre d'affichage (accessible via QScroll- 
Area : : viewport ( )) si ce n'est pas encore le cas. Par exemple, si vous voulez des barres de 
defilement autour du widget IconEditor developpe au Chapitre 5, vous avez la possibility 
d'ecrire ceci : 



int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
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IconEditor *iconEditor = new IconEditor; 
iconEditor->setIconImage(QImage( " : /images/mouse. png" ) ) ; 

QScrollArea scrollArea; 
scrollArea.setWidget (iconEditor) ; 

scrollArea. viewport ( ) ->setBackgroundRole(QPalette: :Dark) ; 
scrollArea. viewport ( )->setAutoFillBackground(true) ; 
scrollArea. setWindowTitle(QObject: :tr("Icon Editor")) ; 

scrollArea. show() ; 
return app.execf) ; 

} 

QScrollArea presente le widget dans sa taille actuelle ou utilise la taille requise si le widget 
n'a pas encore ete redimensionne. En appelant setWidgetResizable (true), vous pouvez 
dire a QScrollArea de redimensionner automatiquement le widget pour profiter de tout 
espace supplemental au-dela de sa taille requise. 

Par defaut, les barres de defilement ne sont affichees que lorsque la fenetre d'affichage est 
plus petite que le widget enfant. Nous pouvons obliger les barres de defilement a etre toujours 
visibles en configurant les strategies de barre de defilement : 

scrollArea. setHorizontalScrollBarPolicy (Qt : :ScrollBarAlwaysOn) ; 
scrollArea. setVerticalScrollBarPolicy(Qt: :ScrollBarAlwaysOn) ; 



Figure 6.12 

Redimensionner 
un QScrollArea 




QScrollArea herite la majorite de ses fonctionnalites de QAbstractScrollArea. Des classes 
comme QTextEdit et QAbstractltemView (la classe de base des classes d'affichage 
d'elements de Qt) derivent de QAbstractScrollArea, nous n'avons done pas a les encadrer 
dans un QScrollArea pour obtenir des barres de defilement. 
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Widgets et barres d'outils ancrables 

Les widgets ancrables sont des widgets qui peuvent etre ancres dans un QMainWindow ou 
rester flottants comme des fenetres independantes. QMainWindow propose quatre zones 
d'accueil pour les widgets ancrables : une en dessous, une au-dessus, une a gauche et une a 
droite du widget central. Des applications telles que Microsoft Visual Studio et Qt Linguist 
utilisent enormement les fenetres ancrables pour offrir une interface utilisateur tres flexible. 
Dans Qt, les widgets ancrables sont des instances de QDockWidget. 

Chaque widget ancrable possede sa propre barre de titre, meme s'il est ancre (voir Figure 6.13). 
Les utilisateurs peuvent deplacer les fenetres ancrables d'une zone a une autre en faisant glis- 
ser la barre de titre. lis peuvent aussi detacher une fenetre ancree d'une zone et en faire une 
fenetre flottante independante en la faisant glisser en dehors de tout point d'ancrage. Les fene- 
tres ancrables sont toujours affichees "au-dessus" de leur fenetre principale lorsqu'elles sont 
flottantes. Les utilisateurs peuvent fermer QDockWidget en cliquant sur le bouton de fermeture 
dans la barre de titre du widget. Toute combinaison de ces fonctions peut etre desactivee en 
appelant QDockWidget : : setFeatures ( ). 



Figure 6.13 

QMainWindow avec 
un widget ancrable 
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Dans les versions anterieures de Qt, les barres d'outils etaient considerees comme des widgets 
ancrables et partageaient les memes points d'ancrage. Avec Qt4, les barres d'outils occupent 
leurs propres zones autour du widget central (comme illustre en Figure 6.14) et ne peuvent pas 
etre detachees. Si une barre d'outils flottante s'avere necessaire, nous pouvons simplement la 
placer dans un QDockWindow. 
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Figure 6.14 

Les points d'ancrage et 
les zones de barres d'outils 
de QMainWindow 
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Les coins materialises avec des lignes pointillees peuvent appartenir a Fun des deux points 
d'ancrage adjacents. Par exemple, nous pourrions instaurer que le coin superieur gauche 
appartient a la zone d'ancrage gauche en appelant QMainWindow: : setCorner(Qt : :TopLeft- 
Corner, Qt : : Lef tDockWidgetArea). 

L'extrait de code suivant montre comment encadrer un widget existant (dans ce cas, 
QTreeWidget) dans un QDockWidget et comment l'inserer dans le point d'ancrage droit : 

QDockWidget *shapesDockWidget = new QDockWidget(tr( "Shapes" )) ; 
shapesDockWidget->setWidget (treeWidget) ; 
shapesDockWidget->setAllowedAreas (Qt : : Lef tDockWidgetArea 

| Qt: :RightDockWidgetArea) ; 
addDockWidget(Qt: :RightDockWidgetArea, shapesDockWidget) ; 

L'appel de setAllowedAreas ( ) specifie les contraintes selon lesquelles les points d'ancrage 
peuvent accepter la fenetre ancrable. Ici, nous autorisons uniquement l'utilisateur a faire glis- 
ser le widget ancrable vers les zones gauche et droite, oil il y a suffisamment d'espace vertical 
pour qu'il s'affiche convenablement. Si aucune zone autorisee n'est explicitement specifiee, 
l'utilisateur a la possibility de faire glisser ce widget vers l'un des quatre points d'ancrage. 

Voici comment creer une barre d'outils contenant un QComboBox, un QSpinBox et quelques 
QToolButton dans le constructeur d'une sous-classe de QMainWindow : 

QToolBar *fontToolBar = new QToolBar(tr("Font")) ; 
f ontToolBar->addWidget (f amilyComboBox) ; 
fontToolBar->addWidget (sizeSpinBox) ; 
fontToolBar->addAction(boldAction) ; 
fontToolBar->addAction(italicAction) ; 
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fontToolBar->addAction(underlineAction) ; 
fontToolBar->setAllowedAreas(Qt : :TopToolBarArea 

| Qt: :BottomToolBarArea) ; 

addToolBarff ontToolBar) ; 

Si nous voulons sauvegarder la position de tous les widgets ancrables et barres d'outils de 
maniere a pouvoir les restaurer la prochaine fois que l' application sera executee, nous pouvons 
ecrire un code similaire a celui utilise pour enregistrer l'etat d'un QSplitter a l'aide des 
fonctions saveState ( ) et restoreState ( ) de QMainWindow : 

void MainWindow: :writeSettings() 
{ 

QSettings settings( "Software Inc.", "Icon Editor"); 

settings. beginGroup( "mainWindow" ) ; 
settings. setValue( "size" , size( ) ) ; 
settings. setValue( "state" , saveState() ) ; 
settings. endGroup() ; 

} 

void MainWindow: :readSettings() 
{ 

QSettings settingsf "Software Inc.", "Icon Editor"); 

settings. beginGroup( "mainWindow" ) ; 
resize (settings. value) "size" ) . toSizef ) ) ; 
restoreState (settings. value ( "state" ) .toByteArray ( ) ) ; 
settings. endGroup() ; 

} 

Enfin, QMainWindow propose un menu contextuel qui repertorie toutes les fenetres ancrables et 
toutes les barres d'outils, comme illustre en Figure 6.15. L'utilisateur peut fermer et restaurer 
ces fenetres et masquer et restaurer des barres d'outils par le biais de ce menu. 

Figure 6.15 

Le menu contextuel 
de QMainWindow 
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MDI (Multiple Document Interface) 

Les applications qui proposent plusieurs documents dans la zone centrale de la fenetre principale 
sont appelees des applications MDI (multiple document interface). Dans Qt, une application 
MDI est creee en utilisant la classe QWorkspace comme widget central et en faisant de chaque 
fenetre de document un enfant de QWorkspace. 



160 Qt4etC++ : Programmation d'interfaces GUI 



Les applications MDI fournissent generalement un menu Fenetre (Window) a partir duquel 
vous gerez les fenetres et les listes de fenetres. La fenetre active est identifiee par une 
coche. L'utilisateur peut activer n'importe quelle fenetre en cliquant sur son entree dans ce 
menu. 

Dans cette section, nous developperons l'application MDI Editor presentee en Figure 6.16 
pour vous montrer comment creer une application MDI et comment implementer son menu 
Window. 



K MDI Editor 
^^^^S Window 



Figure 6.16 

L'application 
MDI Editor 
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Qt COMMERCIAL LICENSE AGREEMENT 
Agreement version 3.0 

IMPORTANT-READ CAREFULLY: 

1 . This Trolltech End-User License Agreement ("Agreement") Is a legal 
agreeme--il between :ed"er an mdividua :r a legs entity; 
("Licensee") and Trolltech AS (" Trolltech ") for the Trolltech software 
produces) accompanying this Agreement, which include is) computer 
software and may include "online" or electronic documentation, 
associated media, and printed materials, including the source code, 
example programs and the documentation ("Licensed Software"). 

2. The Licensed Software is protected by copyright laws and 
international copyright treaties, as well as other intellectual 
property laws and treaties. The Licensed Software is licensed, not 



2 3c Tie c" t'"ie f iea ir the _;e , ";ec 5c-iw='e "a-.e seen g r o.jped nto 
Modules. These files contain specific r :t -es def riing the Module of 
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in the license certificate ("License Certificate"} accompanying the 
Licensee 3c f t , .vare T'-.e terns if the License CeTrfca:e a r e ;'jrs-3e r el 
part of the .Agreement. In the event of inconsistency or conflict 
between the language of this Agreement and the License Certificate, 
the provisions of this Agr e ement shall govern 

4. By installing, copying, or otherwise using the Ucensed Software, 



L'application comprend deux classes : MainWindow et Editor. Le code se trouve sur le site 
www.pearson.fr, a la page dediee a cet ouvrage, et vu qu'une grande partie de celui-ci est 
identique ou similaire a l'application Spreadsheet de la Partie I, nous ne presenterons que les 
parties nouvelles. 
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Commencons par la classe MainWindow. 

MainWindow: :MainWindow( ) 
{ 

workspace = new QWorkspace; 
setCentralWidget(workspace) ; 

connect (workspace, SIGNAL(windowActivated(QWidget *)), 
this, SLOT(updateMenus() ) ) ; 

createActions( ) ; 
createMenus() ; 
createToolBars() ; 
createStatusBar() ; 

setWindowTitle(tr("MDI Editor")) ; 
setWindowIcon(QPixmap( " : /images /icon. png" ) ) ; 

} 

Dans le constructeur MainWindow, nous creons un widget QWorkspace qui devient le widget 
central. Nous connectons le signal windowActivated ( ) de QWorkspace au slot que nous 
voulons utiliser pour conserver le menu Window a jour. 

void MainWindow: : newFile( ) 
{ 

Editor *editor = createEditor( ) ; 
editor->newFile() ; 
editor->show( ) ; 

} 

Le slot newFile( ) correspond a l'option File > New. II depend de la fonction privee create- 
Editor() pourcreer un widget enfant Editor. 

Editor *MainWindow: :createEditor() 
{ 

Editor *editor = new Editor; 
connect(editor, SIGNAL(copyAvailable(bool) ) , 

cutAction, SLOT(setEnabled(bool) ) ) ; 
connect(editor, SIGNAL(copyAvailable(bool) ) , 

copyAction, SLOT(setEnabled(bool) ) ) ; 

workspace->addWindow(editor) ; 

windowMenu->addAction(editor->windowMenuAction( ) ) ; 
windowActionGroup->addAction(editor->windowMenuAction() ) ; 

return editor; 

} 

La fonction createEditor ( ) cree un widget Editor et etablit deux connexions signal-slot. 
Ces connexions garantissent que Edit > Cut et Edit > Copy sont actives ou desactives selon que 
du texte est selectionne ou non. 
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Avec MDI, il est possible que plusieurs widgets Editor soient utilises. C'est un souci parce 
que nous ne voulons repondre qu'au signal copyAvailable(bool) de la fenetre Editor 
active et pas aux autres. Cependant, ces signaux ne peuvent etre emis que par la fenetre active, 
ce n'est done pas un probleme en pratique. 

Lorsque nous avons configure Editor, nous avons ajoute un QAction representant la fenetre 
au menu Window. L' action est fournie par la classe Editor que nous etudierons plus loin. 
Nous ajoutons egalement Taction a un objet QActionGroup. Avec QActionGroup, nous 
sommes stirs qu'un seul element du menu Window est coche a la fois. 

void MainWindow: :open() 
{ 

Editor *editor = createEditor( ) ; 
if (editor->open()) { 

editor->show( ) ; 
} else { 

editor->close( ) ; 

} 

} 

La fonction open ( ) correspond a File > Open. Elle cree un Editor pour le nouveau document 
et appelle open ( ) sur ce dernier. II est preferable d'implementer des operations de fichier dans 
la classe Editor que dans la classe MainWindow, parce que chaque Editor a besoin d'assurer 
le suivi de son propre etat independant. 

Si open() echoue, nous fermons simplement l'editeur parce que l'utilisateur aura deja ete 
informe de l'erreur. Nous n'avons pas a supprimer explicitement l'objet Editor nous-memes ; 
c'est fait automatiquement par Editor par le biais de l'attribut Qt : : WA_DeleteOnClose, qui 
est defini dans le constructeur de Editor. 

void MainWindow: : save( ) 
{ 

if (activeEditor( ) ) 

activeEditor()->save() ; 

} 

Le slot save ( ) invoque Editor : : save ( ) sur l'editeur actif, s'il y en a un. Une fois encore, le 
code qui accomplit le veritable travail se situe dans la classe Editor. 

Editor *MainWindow: :activeEditor() 
{ 

return qobject_cast<Editor *>(workspace->activeWindow() ) ; 

} 

La fonction privee activeEditor ( ) retourne la fenetre enfant active sous la forme d'un pointeur 
de Editor, ou d'un pointeur nul s'il n'y en a pas. 

void MainWindow: : cut () 
{ 

if (activeEditor( ) ) 

activeEditor()->cut() ; 

} 
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Le slot cut() invoque Editor: :cut() sur l'editeur actif. Nous ne montrons pas les slots 
copy ( ) et paste ( ) puisqu'ils suivent le meme modele. 

void MainWindow: : updateMenus( ) 
{ 

bool hasEditor = (activeEditorf) != 0); 
bool hasSelection = activeEditorf) 

&& activeEditor()->textCursor() .hasSelectionf) ; 



saveAction->setEnabled (hasEditor) ; 
saveAsAct ion- >set Enabled ( hasEditor) ; 
pasteAction->setEnabled( hasEditor) ; 
cutAction->setEnabled (hasSelection) ; 
copyAction->setEnabled (hasSelection) ; 
closeAction->setEnabled( hasEditor) ; 
closeAHAct ion- >set Enabled ( hasEditor) ; 
tileAction->set Enabled (hasEditor) ; 
cascadeAction->setEnabled( hasEditor) ; 
nextAct ion->set Enabled ( hasEditor) ; 
pre viousAct ion- >set Enabled (hasEditor) ; 
separatorAction->setVisible( hasEditor) ; 



if (activeEditorf)) 

activeEditorf )->windowMenuAction( ) ->setChecked(true) ; 

} 

Le slot updateMenus ( ) est invoque des qu'une fenetre est activee (et quand la derniere fenetre 
est fermee) pour mettre a jour le systeme de menus, en raison de la connexion signal-slot dans 
le constructeur de MainWindow. 

La plupart des options de menu ne sont interessantes que si une fenetre est active, nous les 
desactivons done quand ce n'est pas le cas. Nous terminons en appelant setChecked() sur 
QAction representant la fenetre active. Grace a QActionGroup, nous n'avons pas besoin de 
decocher explicitement la fenetre active precedente. 

void MainWindow: :createMenus( ) 
{ 

windowMenu = menuBarf ) ->addMenu(tr( "&Window" ) ) ; 
windowMenu->addAction(closeAction) ; 
windowMenu->addAction(closeAHAction) ; 
windowMenu->addSeparator() ; 
windowMenu->addAction(tileAction) ; 
windowMenu->addAction(cascadeAction) ; 
windowMenu->addSeparator( ) ; 
windowMenu- >addAct ion (nextAct ion) ; 
windowMenu->addAction(previousAction) ; 
windowMenu->addAction(separatorAction) ; 



} 
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La fonction privee createMenus() introduit des actions dans le menu Window. Les actions 
sont toutes typiques de tels menus et sont implementees facilement a l'aide des slots close- 
ActiveWindow( ) , closeAHWindows ( ), tile ( ) et cascade ( ) de QWorkspace. A chaque 
fois que l'utilisateur ouvre une nouvelle fenetre, elle est ajoutee a la liste d'actions du menu 
Window. (Ceci est effectue dans la fonction createEditor ( ) etudiee precedemment.) Des 
que l'utilisateur ferme une fenetre d'editeur, son action dans le menu Window est supprimee 
(etant donne que Taction appartient a la fenetre d'editeur), et elle disparait de ce menu. 

void MainWindow: :closeEvent(QCloseEvent *event) 
{ 

workspace->closeAHWindows ( ) ; 
if (activeEditor( ) ) { 

event->ignore( ) ; 
} else { 

event->accept() ; 

} 

} 

La fonction closeEvent ( ) est reimplementee pour fermer toutes les fenetres enfants, chaque 
enfant recoit done un evenement close. Si l'un des widgets enfants "ignore" cet evenement 
(parce que l'utilisateur a annule une boite de message "modifications non enregistrees"), nous 
ignorons l'evenement close pour MainWindow ; sinon, nous l'acceptons, ce qui a pour conse- 
quence de fermer la fenetre complete. Si nous n'avions pas reimplements closeEvent ( ) dans 
MainWindow, l'utilisateur n'aurait pas eu la possibility de sauvegarder des modifications non 
enregistrees. 

Nous avons termine notre analyse de MainWindow, nous pouvons done passer a l'implementa- 
tion d' Editor. La classe Editor represente une fenetre enfant. Elle herite de QTextEdit qui 
propose une fonctionnalite de modification de texte. Tout comme n'importe quel widget Qt 
peut etre employe comme une fenetre autonome, tout widget Qt peut etre utilise comme une 
fenetre enfant dans un espace de travail MDI. 

Voici la definition de classe : 

class Editor : public QTextEdit 
{ 

Q_0BJECT 
public: 

Editor (QWidget *parent = 0); 

void newFile( ) ; 
bool open( ) ; 

bool openFile(const QString &fileName); 

bool save( ) ; 

bool saveAs() ; 

QSize sizeHint() const; 

QAction *windowMenuAction( ) const { return action; } 
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protected : 

void closeEvent(QCloseEvent *event); 

private slots: 

void documentWasModif ied( ) ; 

private: 

bool okToContinue( ) ; 

bool saveFile(const QString &f ileName) ; 

void setCurrentFile(const QString &fileName); 

bool readFile(const QString &f ileName) ; 

bool writeFile (const QString &fileName); 

QString strippedNamefconst QString &f ullFileName) ; 

QString curFile; 
bool isUntitled; 
QString fileFilters; 
QAction *action; 

}; 

Quatre des fonctions privees qui se trouvaient dans la classe MainWindow de l'application 
Spreadsheet sont egalement presentes dans la classe Editor : okToContinue ( ), save- 
File( ), setCurrentFile( ) et strippedName ( ). 

Editor: : Editor (QWidget *parent) 
: QTextEdit(parent) 

{ 

action = new QAction(this) ; 
action->setCheckable(true) ; 

connect(action, SIGNAL(triggered( ) ) , this, SL0T(show( ) ) ) ; 
connect(action, SIGNAL(triggered( ) ) , this, SLOT(setFocus( ) ) ) ; 

isUntitled = true; 

fileFilters = tr("Text files (*.txt)\n" 
"All files (*)"); 

connect(document() , SIGNAL(contentsChanged() ) , 
this, SLOT(documentWasModified())) ; 

setWindowIcon(QPixmap( " : /images /document .png" ) ) ; 
setAttribute(Qt: :WA_DeleteOnClose) ; 

} 

Nous creons d'abord un QAction representant l'editeur dans le menu Window de l'application 
et nous connectons cette action aux slots show( ) et setFocus ( ) . 

Etant donne que nous autorisons les utilisateurs a creer autant de fenetres d'editeurs qu'ils le 
souhaitent, nous devons prendre certaines dispositions concernant leur denomination, dans le but 
de faire une distinction avant le premier enregistrement. Un moyen courant de gerer cette situa- 
tion est d'attribuer des noms qui incluent un chiffre (par exemple, documentl.txt). Nous utilisons 
la variable isUntitled pour faire une distinction entre les noms fournis par l'utilisateur et les 
noms crees par programme. 
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Nous connectons le signal contentsChanged() du document au slot prive documentWas- 
Modif ied ( ). Ce slot appelle simplement setWindowModif ied (true). 

Enfin, nous definissons l'attribut Qt : :WA_DeleteOnClose pour eviter toute fuite de memoire 
quand l'utilisateur ferme une fenetre Editor. 

Apres le constructeur, il est logique d'appeler newFile ( ) ou open ( ) . 

void Editor: :newFile() 
{ 

static int documentNumber = 1 ; 

curFile = tr( "document%1 .txt" ) .arg(documentNumber) ; 
setWindowTitle(curFile + "[*]"); 
action->setText(curFile) ; 
isUntitled = true; 
++documentNumber; 

} 

La fonction newFile( ) genere un nom au format documentl.txt pour le nouveau document. 
Ce code est place dans newFile( ) plutot que dans le constructeur, parce qu'il n'y a aucun 
interet a numeroter quand nous invoquons open ( ) pour ouvrir un document existant dans un 
Editor nouvellement cree. documentNumber etant declare statique, il est partage par toutes 
les instances d' Editor. 

Le symbole "[*]" dans le titre de la fenetre reserve l'emplacement de l'asterisque qui doit 
apparaitre quand le fichier contient des modifications non sauvegardees sur des plates-formes 
autres que Mac OS X. Nous avons parle de ce symbole dans le Chapitre 3. 

bool Editor: :open( ) 
{ 

QString fileName = 

QFileDialog: :getOpenFileName(this, tr("0pen"), 

f ileFilters) ; 

if (fileName. isEmptyO) 
return false; 

return openFile (fileName) ; 

} 

La fonction open ( ) essaie d'ouvrir un fichier existant avec openFile ( ). 

bool Editor: :save( ) 
{ 

if (isUntitled) { 

return saveAsf) ; 
} else { 

return saveFile(curFile) ; 

} 

} 
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La fonction save ( ) s'appuie sur la variable isUntitled pour determiner si elle doit appeler 
saveFile( ) ou saveAs( ). 

void Editor: :closeEvent(QCloseEvent *event) 
{ 

if (okToContinue( ) ) { 

event->accept() ; 
} else { 

event->ignore( ) ; 

} 

} 

La fonction closeEvent( ) est reimplementee pour permettre a l'utilisateur de sauvegarder 
des modifications non enregistrees. La logique est codee dans la fonction okToContinue ( ) 
qui ouvre une boite de message demandant, "Voulez-vous enregistrer vos modifications ?" 
Si okToContinue ( ) retourne true, nous acceptons l'evenement close ; sinon, nous "l'ignorons" 
et la fenetre n'en sera pas affectee. 

void Editor: :setCurrentFile(const QString SfileName) 
{ 

curFile = fileName; 
isUntitled = false; 

action->setText(strippedName(curFile) ) ; 

document()->setModified(false) ; 
setWindowTitle(strippedName(curFile) + "[*]"); 
setWindowModif ied (false) ; 

} 

La fonction setCurrentFile ( ) est appelee dans openFile ( ) et saveFile ( ) pour mettre a 
jour les variables curFile et isUntitled, pour definir le titre de la fenetre et le texte de 
Taction et pour configurer l'indicateur "modi?ed" du document en false. Des que l'utilisateur 
modifie le texte dans l'editeur, le QTextDocument sous-jacent emet le signal contentsChanged ( ) 
et definit son indicateur "modified" interne en true. 

QSize Editor: :sizeHint() const 
{ 

return QSize(72 * fontMetrics( ) .width ( 'x' ) , 

25 * fontMetrics() .lineSpacing() ) ; 

} 

La fonction sizeHint() retourne une faille en fonction de la largeur de la lettre "x" et de la 
hauteur de la ligne de texte. QWorkspace se sert de la faille requise pour attribuer une dimension 
initiale a la fenetre. 

Voici le fichier main . cpp de l'application MDI Editor : 
#include <QApplication> 
#include "mainwindow.h" 
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int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
QStringList args = app. arguments () ; 

MainWindow mainWin; 
if (args. count) ) > 1) { 

for (int i = 1; i < args.count() ; ++i) 
mainWin.openFile(args[i] ) ; 
} else { 

mainWin.newFile() ; 

} 

mainWin.show() ; 
return app.execf) ; 

} 

Si l'utilisateur specifie des fichiers dans la ligne de commande, nous tentons de les charger. 
Sinon, nous demarrons avec un document vide. Les options de ligne de commande specifiques 
a Qt, comme -style et -font, sont automatiquement supprimees de la liste d' arguments par 
le constructeur QApplication. Done si nous ecrivons : 

mdieditor -style motif readme.txt 

dans la ligne de commande, QApplication : : arguments ( ) retourne un QStringList conte- 
nant deux elements ("mdieditor" et "readme.txt") et l'application MDI Editor demarre 
avec le document readme . txt. 

MDI est un moyen de gerer simultanement plusieurs documents. Sous Mac OS X, la meilleure 
approche consiste a utiliser plusieurs fenetres de haut niveau. Cette technique est traitee dans la 
section "Documents multiples" du Chapitre 3. 
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Au sommaire de ce chapitre 
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Les evenements sont declenches par le systeme de fenetrage ou par Qt en reponse a 
diverses circonstances. Quand l'utilisateur enfonce ou relache une touche ou un bouton 
de la souris, un evenement key ou mouse est declenche ; lorsqu'une fenetre s'affiche 
pour la premiere fois, un evenement paint est genere pour informer la fenetre 
nouvellement affichee qu'elle doit se redessiner. La plupart des evenements sont 
declenches en reponse a des actions utilisateur, mais certains, comme les evenements 
tinier, sont declenches independamment par le systeme. 
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Quand nous programmons avec Qt, nous avons rarement besoin de penser aux evene- 
ments, parce que les widgets Qt emettent des signaux lorsque quelque chose de significatif 
se produit. Les evenements deviennent utiles quand nous ecrivons nos propres widgets person- 
nalises ou quand nous voulons modifier le comportement des widgets Qt existants. 

II ne faut pas confondre evenements et signaux. En regie generale, les signaux s'averent utiles 
lors de I'emploi d'un widget, alors que les evenements presentent une utilite au moment de 
V implementation d'un widget. Par exemple, quand nous utilisons QPushButton, nous nous 
interessons plus a son signal clicked ( ) qu'aux evenements mouse ou key de bas niveau qui 
provoquent remission du signal. Cependant, si nous implementons une classe telle que QPush- 
Button, nous devons ecrire un code qui gerera les evenements mouse et key et qui emettra le 
signal clicked ( ) si necessaire. 

Reimplementer les gestionnaires d'evenements 

Dans Qt, un evenement est un objet qui herite de QEvent. Qt gere plus d'une centaine de types 
d'evenements, chacun d'eux etant identifie par une valeur d' enumeration. Par exemple, 
QEvent :: type ( ) retourne QEvent :: MouseButtonPress pour les evenements "bouton 
souris enfonce". 

De nombreux types d'evenements exigent plus d' informations que ce qui peut etre stocke dans 
un objet QEvent ordinaire ; par exemple, les evenements "bouton souris enfonce" doivent stacker 
quel bouton de la souris a declenche 1' evenement et l'endroit oil le pointeur de la souris se 
trouvait quand l'evenement s'est declenche. Ces informations supplementaires sont conservees 
dans des sous-classes QEvent speciales, comme QMouseEvent. 

Les evenements sont notifies aux objets par le biais de leur fonction event (), heritee de 
QObject. L implementation de event () dans QWidget transmet les types les plus courants 
d'evenements a des gestionnaires d'evenements specifiques, tels que mousePressEvent ( ), 
keyPressEvent ( ) et paintEvent ( ). 

Nous avons deja etudie plusieurs gestionnaires d'evenements lorsque nous avons implements 
MainWindow, IconEditor et Plotter dans les chapitres precedents. II existe beaucoup 
d'autres types d'evenements repertories dans la documentation de reference de QEvent, et il 
est aussi possible de creer des types d'evenements personnalises et d'envoyer les evenements 
soi-meme. Dans notre cas, nous analyserons deux types courants d'evenements qui meritent 
davantage d'explications : les evenements key et timer. 

Les evenements key sont geres en reimplementant keyPressEvent ( ) et keyRelease- 
Event ( ). Le widget Plotter reimplemente keyPressEvent ( ). Normalement, nous ne devons 
reimplementer que keyPressEvent ( ) puisque les seules touches pour lesquelles il faut 
controler qu'elles ont ete relachees sont les touches de modification Ctrl, Maj et Alt, et vous pouvez 
controler leur etat dans un keyPressEvent ( ) en utilisant QKeyEvent: : modifiers ( ). 
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Par exemple, si nous implementions un widget CodeEditor, voici le code de sa fonction 
keyPressEvent ( ) qui devra interpreter differemment Home et Ctrl+Home : 

void CodeEditor: : keyPressEvent (QKeyEvent *event) 
{ 

switch (event->key( ) ) { 
case Qt: :Key_Home: 

if (event->modif iers( ) & Qt: :ControlModif ier) { 

goToBeginningOfDocumentf ) ; 
} else { 

goToBeginningOf Line ( ) ; 

} 

break; 
case Qt: :Key_End: 

default : 

QWidget: : keyPressEvent(event) ; 

} 

} 

Les touches de tabulation et de tabulation arriere (Maj+Tab) sont des cas particuliers. Elles 
sont gerees par QWidget : : event ( ) avant l'appel de keyPressEvent ( ), avec la consigne de 
transmettre le focus au widget suivant ou precedent dans l'ordre de la chaine de focus. Ce 
comportement correspond habituellement a ce que nous recherchons, mais dans un widget 
CodeEditor, nous prefererions que la touche Tab produise le decalage d'une ligne par rapport 
a la marge. Voici comment event ( ) pourrait etre reimplemente : 

bool CodeEditor: :event(QEvent *event) 
{ 

if (event->type() == QEvent: :KeyPress) { 

QKeyEvent *keyEvent = static_cast<QKeyEvent *>(event); 
if (keyEvent->key() == Qt::Key_Tab) { 

insertAtCurrentPosition ( ' \t 1 ) ; 

return true; 

} 

} 

return QWidget: :event(event) ; 

} 

Si l'evenement est lie a une touche sur laquelle l'utilisateur a appuye, nous convertissons 
l'objet QEvent en QKeyEvent et nous verifions quelle touche a ete pressee. S'il s'agit de la 
touche Tab, nous effectuons un traitement et nous retournons true pour informer Qt que nous 
avons gere l'evenement. Si nous avions retourne false, Qt transmettrait l'evenement au 
widget parent. 

Une approche plus intelligente pour implementer les combinaisons de touches consiste a se 
servir de QAction. Par exemple, si goToBeginningOf Line ( ) et goToBeginningOf - 
Document () sont des slots publics dans le widget CodeEditor, et si CodeEditor fait 
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office de widget central dans une classe MainWindow, nous pourrions ajouter des combinaisons 
de touches avec le code suivant : 

MainWindow: : MainWindow ( ) 
{ 

editor = new CodeEditor; 
setCentralWidget(editor) ; 

goToBeginningOf LineAction = 

new QAction(tr( "Go to Beginning of Line"), this); 
goToBeginningOfLineAction->setShortcut(tr( "Home" ) ) ; 
connect (goToBeginningOf LineAction, SIGNAL ( activated ( ) ) , 

editor, SLOT(goToBeginningOf Line( ) ) ) ; 

goToBeginningOfDocumentAction = 

new QAction(tr( "Go to Beginning of Document"), this); 
goToBeginningOf DocumentAction->setShortcut (tr( "Ctrl+Home" ) ) ; 
connect (goToBeginningOf DocumentAction, SIGNAL(activated( ) ) , 

editor, SLOT(goToBeginningOf Document ( ) ) ) ; 

} 

Cela permet d'ajouter facilement des commandes a un menu ou une barre d'outils, comme 
nous l'avons vu dans le Chapitre 3. Si les commandes n'apparaissent pas dans l'interface utili- 
sateur, les objets QAction pourraient etre remplaces par un objet QShortcut, la classe 
employee par QAction en interne pour prendre en charge les combinaisons de touches. 

Par defaut, les combinaisons de touches definies a l'aide de QAction ou QShortcut sur un 
widget sont activees des que la fenetre contenant le widget est active. Vous pouvez modifier ce 
comportement grace a QAction : : setShortcutContext ( ) ou QShortcut : : setContext ( ). 

L' autre type courant d'evenement est l'evenement tinier. Alors que la plupart des autres types 
d'evenements se declenchent suite a une action utilisateur, les evenements timer permettent 
aux applications d'effectuer un traitement a intervalles reguliers. Les evenements timer 
peuvent etre utilises pour implementer des curseurs clignotants et d' autres animations, ou 
simplement pour reactualiser l'affichage. 

Pour analyser les evenements timer, nous implementerons un widget Ticker illustre en 
Figure 7.1. Ce widget presente une banniere qui defile d'un pixel vers la gauche toutes les 
30 millisecondes. Si le widget est plus large que le texte, le texte est repete autant de fois que 
necessaire pour remplir toute la largeur du widget. 

Figure 7.1 

Le widget Ticker 3 Sa V ++ HoW ,on 9 lasted was impossible to Say ++ H0\ 

Voici le fichier d'en-tete : 

#ifndef TICKER_H 
#define TICKER H 
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#include <QWidget> 

class Ticker : public QWidget 
{ 

Q_OBJECT 

Q_PROPERTY(QString text READ text WRITE setText) 
public: 

Ticker (QWidget *parent = 0); 

void setText(const QString &newText); 
QString text() const { return myText; } 
QSize sizeHint() const; 

protected: 

void paintEventfQPaintEvent *event); 
void timerEventfQTimerEvent *event); 
void showEvent (QShowEvent *event); 
void hideEvent(QHideEvent *event); 

private: 

QString myText; 
int offset; 
int myTimerld; 

}; 

#endif 

Nous reimplementons quatre gestionnaires d'evenements dans Ticker, dont trois que nous 
avons deja vus auparavant : timerEvent ( ), showEvent ( ) et hideEvent ( ). 

Analysons a present 1' implementation : 

#include <QtGui> 

#include "ticker. h" 

Ticker: :Ticker(QWidget *parent) 
: QWidget (parent) 

{ 

offset = 0; 
myTimerld = 0; 

} 

Le constructeur initialise la variable offset a 0. Les coordonneesx auxquelles le texte est 
dessine sont calculees a partir de la valeur offset. Les ID du timer sont toujours differents de 
zero, nous utilisons done 0 pour indiquer qu'aucun timer n'a ete demarre. 

void Ticker: :setText(const QString &newText) 
{ 

myText = newText; 
update( ) ; 
updateGeometry() ; 

} 
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La fonction setText ( ) determine le texte a afficher. Elle invoque update ( ) pour demander le 
rafraichissement de l'affichage et updateGeometry ( ) pour informer tout gestionnaire de dispo- 
sition responsable du widget Ticker d'un changement de taille requise. 

QSize Ticker: :sizeHint() const 
{ 

return fontMetrics() .size(0, text()); 

} 

La fonction sizeHint ( ) retourne l'espace requis par le texte comme etant la taille ideale du 
widget. (Midget: : f ontMetrics ( ) renvoie un objet QFontMetrics qui peut etre interroge 
pour obtenir des informations liees a la police du widget. Dans ce cas, nous demandons la taille 
exigee par le texte. (Puisque le premier argument de QFontMetrics : : size ( ) est un indicateur 
qui n'est pas necessaire pour les chaines simples, nous transmettons simplement 0.) 

void Ticker: :paintEvent(QPaintEvent * /* event */) 
{ 

QPainter painter(this) ; 

int textWidth = fontMetrics() .width(text() ) ; 
if (textWidth < 1) 

return; 
int x = -offset; 
while (x < width()) { 

painter. drawText(x, 0, textWidth, height(), 

Qt: :AlignLeft | Qt : :AlignVCenter, text()); 

x += textWidth; 

} 

} 

La fonction paintEvent ( ) dessine le texte avec QPainter: : drawText ( ). Elle determine la 
quantite d'espace horizontal exige par le texte a l'aide de f ontMetrics ( ), puis dessine 
le texte autant de fois que necessaire pour remplir toute la largeur du widget, en tenant compte 
du decalage offset. 

void Ticker: :showEvent(QShowEvent * /* event */) 
{ 

myTimerld = startTimer(30) ; 

} 

La fonction showEvent ( ) lance un timer. Lappel de QOb j ect : : startTimer ( ) retourne un 
ID, qui peut etre utilise ulterieurement pour identifier le timer. QOb] ect prend en charge 
plusieurs timers independants, chacun possedant son propre intervalle de temps. Apres l'appel 
de startTimer ( ) , Qt declenche un evenement timer environ toutes les 30 millisecondes ; la 
precision depend du systeme d' exploitation sous-jacent. 

Nous aurions pu appeler startTimer ( ) dans le constructeur de Ticker, mais nous economisons 
des ressources en ne declenchant des evenements timer que lorsque le widget est visible. 

void Ticker: :timerEvent(QTimerEvent *event) 
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{ 

if (event->timerld( ) == myTimerld) { 
++offset; 

if (offset >= fontMetrics() .width (text ( ) ) ) 

offset = 0; 
scroll(-1, 0); 
} else { 

QWidget: :timerEvent(event) ; 

} 

} 

La fonction timerEvent ( ) est invoquee a intervalles reguliers par le systeme. Elle incremente 
offset de 1 pour simuler un mouvement, encadrant la largeur du texte. Puis elle fait defiler le 
contenu du widget d'un pixel vers la gauche grace a QWidget : : scroll () . Nous aurions pu 
simplement appeler update( ) au lieu de scroll( ), mais scroll( ) est plus efficace, parce 
qu'elle deplace simplement les pixels existants a l'ecran et ne declenche un evenement paint 
que pour la zone nouvellement affichee du widget (une bande d'un pixel de large dans ce cas). 

Si T evenement timer ne correspond pas au timer qui nous interesse, nous le transmettons a 
notre classe de base. 

void Ticker: :hideEvent(QHideEvent * /* event */) 
{ 

killTimer(myTimerld) ; 

} 

La fonction hideEvent ( ) invoque QOb j ect : : killTimer ( ) pour arreter le timer. 

Les evenements tinier sont de bas niveau, et si nous avons besoin de plusieurs timers, il peut 
etre fastidieux d' assurer le suivi de tous les ID de timer. Dans de telles situations, il est genera- 
lement plus facile de creer un objet QTimer pour chaque timer. QTimer emet le signal 
timeout ( ) a chaque intervalle de temps. QTimer propose aussi une interface pratique pour les 
timers a usage unique (les timers qui ne chronometrent qu'une seule fois). 



Installer des filtres cT evenements 

Lune des fonctionnalites vraiment puissante du modele d'evenement de Qt est qu'une instance 
de QOb] ect peut etre configuree de maniere a controler les evenements d'une autre instance de 
QOb j ect avant meme que cette derniere ne les detecte. 

Supposons que nous avons un widget Customerlnf oDialog compose de plusieurs QLine- 
Edit et que nous voulons utiliser la barre d'espace pour activer le prochain QLineEdit. Ce 
comportement inhabituel peut se reveler approprie pour une application interne a laquelle les 
utilisateurs sont formes. Une solution simple consiste a deriver QLineEdit et a reimplementer 
keyPressEvent ( ) pour appeler f ocusNextChild ( ), comme dans le code suivant : 

void MyLineEdit: : keyPressEvent (QKeyEvent *event) 
{ 



176 Qt4etC++ : Programmation d'interfaces GUI 



if (event->key ( ) == Qt: :Key_Space) { 

focusNextChild() ; 
} else { 

QLineEdit: :keyPressEvent(event) ; 

} 

} 

Cette approche presente un inconvenient de taille : si nous utilisons plusieurs types de widgets 
dans le formulaire (par exemple, QComboBoxes et QSpinBoxes), nous devons egalement les 
deriver pour qu'ils affichent le meme comportement. II existe une meilleure solution : Custo- 
merlnf oDialog controle les evenements "bouton souris enfonce" de ses widgets enfants et 
implemente le comportement necessaire dans le code de controle. Pour ce faire, vous utiliserez 
des filtres d' evenements. Derinir un filtre d'evenement implique deux etapes : 

1. enregistrer l'objet controleur avec l'objet cible en appelant installEventFilter ( ) sur la 
cible ; 

2. gerer les evenements de l'objet cible dans la fonction eventFilter ( ) de l'objet controleur. 
Le code du constructeur de CustomerlnfoDialog constitue un bon endroit pour enregistrer 
l'objet controleur : 

CustomerlnfoDialog: :CustomerInfoDialog(QWidget *parent) 
: QDialog(parent) 

{ 

f irstNameEdit- >installEvent Filter (this) ; 
lastNameEdit->installEventFilter(this) ; 
city Edit- >installE vent Filter (this) ; 
phoneNumberEdit->installEvent Filter (this) ; 

} 

Des que le filtre d'evenement est enregistre, les evenements qui sont envoyes aux widgets 
f irstNameEdit, lastNameEdit, cityEdit et phoneNumberEdit sont d'abord transmis a la 
fonction eventFilter ( ) de CustomerlnfoDialog avant d'etre envoyes vers la destination 
prevue. 

Voici la fonction eventFilter () qui recoit les evenements : 

bool CustomerlnfoDialog: :eventFilter(QObject *target, QEvent *event) 
{ 

if (target == f irstNameEdit | | target == lastNameEdit 

| | target == cityEdit j j target == phoneNumberEdit) { 
if (event->type( ) == QEvent: :KeyPress) { 

QKeyEvent *keyEvent = static_cast<QKeyEvent *>(event); 
if (keyEvent->key( ) == Qt: :Key_Space) { 
focusNextChild() ; 
return true; 

} 

} 

} 

return QDialog: :eventFilter(target, event); 

} 
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Nous verifions tout d'abord que le widget cible est un des QLineEdit. Si l'evenement est lie a 
l'enfoncement d'une touche, nous le convertissons en QKeyEvent et nous verifions quelle 
touche a ete pressee. Si la touche enfoncee correspondait a la barre d'espace, nous invoquons 
focusNextChild() pour activer le prochain widget dans la chaine de focus, et nous retour- 
nons true pour dire a Qt que nous avons gere l'evenement. Si nous avions renvoye f alse, Qt 
aurait envoye l'evenement a sa cible prevue, ce qui aurait introduit un espace parasite dans 
QLineEdit. 

Si le widget cible n'est pas un QLineEdit, ou si l'evenement ne resulte pas de l'enfoncement 
de la barre d'espace, nous passons le controle a 1' implementation de eventFilter ( ) de la 
classe de base. Le widget cible aurait aussi pu etre un widget que la classe de base, QDialog, 
est en train de controler. (Dans Qt 4.1, ce n'est pas le cas pour QDialog . Cependant, d'autres 
classes de widgets Qt, comme QScrollArea, surveillent certains de leurs widgets enfants pour 
diverses raisons.) 

Qt propose cinq niveaux auxquels des evenements peuvent etre traites et filtres : 

1. Nous pouvons reimplementer un gestionnaire d'evenements specifique. 

Reimplementer des gestionnaires d'evenements comme mousePressEvent ( ), keyPress- 
Event ( ) et paintEvent ( ) est de loin le moyen le plus commun de traiter des evenements. 
Nous en avons deja vu de nombreux exemples. 

2. Nous pouvons reimplementer QOb ject : : event ( ). 

En reimplementant la fonction event (), nous avons la possibilite de traiter des evene- 
ments avant qu'ils n'atteignent les gestionnaires d'evenements specifiques. Cette approche 
est surtout employee pour redefinir la signification par defaut de la touche Tab, comme 
explique precedemment. Elle est aussi utilisee pour gerer des types rares d'evenements 
pour lesquels il n'existe aucun gestionnaire d'evenements specifique (par exemple, 
QEvent : : HoverEnter). Quand nous reimplementons event ( ), nous devons appeler la 
fonction event ( ) de la classe de base pour gerer les cas que nous ne gerons pas explici- 
tement. 

3. Nous pouvons installer un nitre d'evenement sur un seul QOb ject. 

Lorsqu'un objet a ete enregistre avec installEventFilter ( ), tous les evenements pour 
l'objet cible sont d'abord envoyes a la fonction eventFilter ( ) de l'objet controleur. Si 
plusieurs filtres d'evenements sont installes sur le meme objet, les filtres sont actives a tour 
de role, du plus recemment installe au premier installe. 

4. Nous pouvons installer un nitre d'evenement sur l'objet QApplication. 

Lorsqu'un filtre d'evenement a ete enregistre pour qApp (l'unique objet de QApplica- 
tion), chaque evenement de chaque objet de l'application est envoye a la fonction event- 
Filter ( ) avant d'etre transmis a un autre filtre d'evenement. Cette technique est tres utile 
pour le debogage. Elle peut aussi etre employee pour gerer des evenements mouse transmis 
aux widgets desactives que QApplication ignore normalement. 
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5. Nous pouvons deriver QApplication et reimplementer notif y ( ). 

Qt appelle QApplication : : notif y ( ) pour envoyer un evenement. Reimplementer cette 
fonction est le seul moyen de recuperer tous les evenements avant qu'un filtre d'evenement 
quelconque n'ait l'opportunite de les analyser. Les nitres d'evenements sont generalement 
plus pratiques, parce que le nombre de nitres concomitants n'est pas limite alors qu'il ne 
peut y avoir qu'une seule fonction notify ( ) . 

De nombreux types d'evenements, dont les evenements mouse et key, peuvent se propager. Si 
l'evenement n'a pas ete gere lors de son trajet vers son objet cible ou par l'objet cible lui- 
meme, tout le traitement de l'evenement est repete, mais cette fois-ci avec comme cible le 
parent de l'objet cible initial. Ce processus se poursuit, en passant d'un parent a l'autre, 
jusqu'a ce que l'evenement soit gere ou que l'objet de niveau superieur soit atteint. 

La Figure 7.2 vous montre comment un evenement "bouton souris enfonce" est transmis 
d'un enfant vers un parent dans une boite de dialogue. Quand l'utilisateur appuie sur une 
touche, l'evenement est d'abord envoye au widget actif, dans ce cas le QCheckBox en bas a 
droite. Si le QCheckBox ne gere pas l'evenement, Qt l'envoie au QGroupBox et enfin a 
l'objet QDialog. 



Figure 7.2 

Propagation d'un evene- 
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Rester reactif pendant un traitement intensif 

Quand nous appelons QApplication : : exec ( ), nous demarrons une boucle d'evenement de 
Qt. Qt emet quelques evenements au demarrage pour afficher et dessiner les widgets. Puis, la 
boucle d'evenement est executee, controlant en permanence si des evenements se sont declenches 
et envoyant ces evenements aux QOb j ect dans 1' application. 

Pendant qu'un evenement est traite, des evenements supplementaires peuvent etre declenches 
et ajoutes a la file d'attente d'evenements de Qt. Si nous passons trop de temps a traiter un 
evenement particulier, l'interface utilisateur ne repondra plus. Par exemple, tout evenement 
declenche par le systeme de fenetrage pendant que 1' application enregistre un fichier sur le 
disque ne sera pas traite tant que le fichier n'a pas ete sauvegarde. Pendant l'enregistrement, 
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l' application ne repondra pas aux requetes du systeme de fenetrage demandant le rafraichissement 
de l'affichage. 

Une solution consiste a utiliser plusieurs threads : un thread pour l'interface utilisateur de l'appli- 
cation et un autre pour accomplir la sauvegarde du fichier (ou toute autre operation de longue 
duree). De cette facon, l'interface utilisateur de l' application continuera a repondre pendant 
l'enregistrement du fichier. Nous verrons comment y parvenir dans le Chapitre 18. 

Une solution plus simple consiste a appeler frequemment QApplication :: process- 
Events ( ) dans le code de sauvegarde du fichier. Cette fonction demande a Qt de traiter tout 
evenement en attente, puis retourne le controle a l'appelant. En fait, QApplica- 
tion: :exec() ne se limite pas a une simple boucle while autour d'un appel de fonction 
processEvents ( ). 

Voici par exemple comment vous pourriez obtenir de l'interface utilisateur qu'elle reste reac- 
tive a l'aide de processEvents ( ), face au code de sauvegarde de fichier de l'application 
Spreadsheet (voir Chapitre 4) : 

bool Spreadsheet: :writeFile(const QString &fileName) 
{ 

QFile f ile(f ileName) ; 

for (int row = 0; row < RowCount; ++row) { 

for (int column = 0; column < ColumnCount; ++column) { 
QString str = formula(row, column); 
if ( !str.isEmpty() ) 

out « quint16(row) « quint16(column) « str; 

} 

qApp->processEvents( ) ; 

} 

return true; 

} 

Cette approche presente un risque : l'utilisateur peut fermer la fenetre principale alors que 
l'application est toujours en train d'effectuer la sauvegarde, ou meme cliquer sur File > Save 
une seconde fois, ce qui provoque un comportement indetermine. La solution la plus simple a 
ce probleme est de remplacer 

qApp->processEvents( ) ; 

par 

qApp->processEvents(QEventLoop: :ExcludeUserInputEvents) ; 
qui demande a Qt d'ignorer les evenements mouse et key. 

Nous avons souvent besoin d'afficher un QProgressDialog alors qu'une longue operation se 
produit. QProgressDialog propose une barre de progression qui informe l'utilisateur de 
l'avancement de l'operation. QProgressDialog propose aussi un bouton Cancel qui permet a 
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l'utilisateur d'annuler l'operation. Voici le code permettant d'enregistrer une feuille de calcul 
avec cette approche : 

bool Spreadsheet: :writeFile(const QString &fileName) 
{ 

QFile f ile(f ileName) ; 
QProgressDialog progress(this) ; 

progress. set LabelText(tr( "Saving %1 " ) . arg(f ileName) ) ; 
progress. setRange(0, RowCount); 
progress. setModal(true) ; 

for (int row = 0; row < RowCount; ++row) { 
progress. setValue(row) ; 
qApp->processEvents() ; 
if (progress. wasCanceled()) { 
file.remove() ; 
return false; 

} 

for (int column = 0; column < ColumnCount; ++column) { 
QString str = formula(row, column); 
if (!str.isEmpty()) 

out « quint16(row) « quint16(column) « str; 

} 

} 

return true; 

} 

Nous creons un QProgressDialog avec NumRows comme nombre total d'etapes. Puis, pour 
chaque ligne, nous appelons setValue() pour mettre a jour la barre de progression. QPro- 
gressDialog calcule automatiquement un pourcentage en divisant la valeur actuelle d'avan- 
cement par le nombre total d'etapes. Nous invoquons QApplication : : processEvents ( ) 
pour traiter tout evenement de rafraichissement d' affichage, tout clic ou toute touche enfoncee 
par l'utilisateur (par exemple pour permettre a l'utilisateur de cliquer sur Cancel). Si l'utilisateur 
clique sur Cancel, nous annulons la sauvegarde et nous supprimons le richier. 

Nous n'appelons pas show() sur QProgressDialog parce que les boites de dialogue de 
progression le font. Si l'operation se revele plus courte, peut-etre parce que le fichier a enre- 
gistrer est petit ou parce que l'ordinateur est rapide, QProgressDialog le detectera et ne 
s'affichera pas du tout. 

En complement du multithread et de l'utilisation de QProgressDialog, il existe une maniere 
totalement differente de traiter les longues operations : au lieu d'accomplir le traitement a la 
demande de l'utilisateur, nous pouvons ajourner ce traitement jusqu' a ce que 1' application soit 
inactive. Cette solution peut etre envisagee si le traitement peut etre interrompu et repris en 
toute securite, parce que nous ne pouvons pas predire combien de temps 1' application sera 
inactive. 
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Dans Qt, cette approche peut etre implemented en utilisant un timer de 0 milliseconde. Ces 
timers chronometrent des qu'il n'y a pas d'evenements en attente. Voici un exemple d'imple- 
mentation de timerEvent ( ) qui presente cette approche : 

void Spreadsheet: :timerEvent(QTimerEvent *event) 
{ 

if (event->timerld( ) == myTimerld) { 

while (step < MaxStep && !qApp->hasPendingEvents( ) ) { 
performStep(step) ; 
++step; 

} 

} else { 

QTableWidget: :timerEvent(event) ; 

} 

} 

Si hasPendingEvents() retourne true, nous interrompons le traitement et nous redonnons 
le controle a Qt. Le traitement reprendra quand Qt aura gere tous ses evenements en attente. 
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Au sommaire de ce chapitre 

*/ Dessiner avec QPainter 

i/ Transformations du painter 

^ Affichage de haute qualite avec Qlmage 

^ Impression 

^ Graphiques avec OpenGL 



Les graphiques 2D de Qt se basent sur la classe QPainter. QPainter peut tracer des 
formes geometriques (points, lignes, rectangles, ellipses, arcs, cordes, segments, poly- 
gones et courbes de Bezier), de meme que des objets pixmaps, des images et du texte. 
De plus, QPainter prend en charge des fonctionnalites avancees, telles que l'anticre- 
nelage (pour les bords du texte et des formes), le melange alpha, le remplissage degrade 
et les traces de vecteur. QPainter supporte aussi les transformations qui permettent de 
dessiner des graphiques 2D independants de la resolution. 

QPainter peut egalement etre employee pour dessiner sur un "peripherique de dessin" tel 
qu'un QWidget, QPixmap ou Qlmage. C'est utile quand nous ecrivons des widgets 
personnalises ou des classes d'elements personnalisees avec leurs propres aspect et appa- 
rence. II est aussi possible d'utiliser QPainter en association avec QPrinter pour impri- 
mer et generer des fichiers PDF. Cela signifie que nous pouvons souvent nous servir du 
meme code pour afficher des donnees a l'ecran et pour produire des rapports imprimes. 
II existe une alternative a QPainter : OpenGL. OpenGL est une bibliotheque standard 
permettant de dessiner des graphiques 2D et 3D. Le module QtOpenGL facilite 1' inte- 
gration de code OpenGL dans des applications Qt. 
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Dessiner avec QPainter 



Pour commencer a dessiner sur un peripherique de dessin (generalement un widget), nous 
creons simplement un QPainter et nous transmettons un pointeur au peripherique. Par exemple : 

void MyWidget: :paintEvent(QPaintEvent *event) 
{ 

QPainter painter(this) ; 

} 

Nous avons la possibility de dessiner differentes formes a l'aide des fonctions draw. . . ( ) de 
QPainter. La Figure 8.1 repertorie les plus importantes. Les parametres de QPainter inrluencent 
la facon de dessiner. 



Figure 8.1 

Les fonctions draw. ..() 
de QPainter les plus 
frequemment utilisees 
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Certains d'entre eux proviennent du peripherique, d'autres sont initialises a leurs valeurs par 
defaut. Les trois principaux parametres sont le crayon, le pinceau et la police : 

• Le crayon est utilise pour tracer des lignes et les contours des formes. II est constitue d'une 
couleur, d'une largeur, d'un style de trait, de capuchon et de jointure (Figures 8.2 et 8.3). 

• Le pinceau permet de remplir des formes geometriques. II est compose normalement d'une 
couleur et d'un style, mais peut egalement appliquer une texture (un pixmap repete a 
1'infini) ou un degrade (Voir Figure 8.4). 

• La police est utilisee pour dessiner le texte. Une police possede de nombreux attributs, dont 
une famille et une taille. 



Figure 8.2 

Styles de capuchon 
et de jointure 



FlatCap SquareCap RoundCap 




MiterJoin BevelJoin RoundJoin 



Figure 8.3 

Styles de crayon 





Largeur de trait 
12 3 4 


NoPen 

Solid Line 

DashLine 

DotLine 

DashDotLine 

DashDotDotLine 















Figure 8.4 

Styles predefinis 
de pinceau 




SolidPattern Densel Pattern Dense2Pattern Dense3Pattern Dense4Pattern 
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Ces parametres peuvent etre modifies a tout moment en appelant setPen ( ) , setBrush ( ) et 
setFont ( ) avec un objet QPen, QBrush ou QFont. 

Figure 8.5 



Exemples de formes 
geometriques 




(a) Une ellipse (b) Un segment (o) Une courbe de Bezier 



Analysons quelques exemples pratiques. Voici le code permettant de dessiner l'ellipse illustree 
en Figure 8.5 (a) : 

QPainter painter(this) ; 

painter. setRenderHint(QPainter: :Antialiasing, true) ; 

painter. setPen(QPen(Qt: :black, 12, Qt: :DashDotLine, Qt : :RoundCap) ) ; 

painter. setBrush(QBrush(Qt: :green, Qt: :SolidPattern) ) ; 

painter. drawEllipse(80, 80, 400, 240); 

L'appel de setRenderHint ( ) active Fanticrenelage, demandant a QPainter d'utiliser diverses 
intensites de couleur sur les bords pour reduire la distorsion visuelle qui se produit habituel- 
lement quand les contours d'une forme sont convertis en pixels. Les bords sont done plus homo- 
genes sur les plates-formes et les peripheriques qui prennent en charge cette fonctionnalite. 

Voici le code permettant de dessiner le segment illustre en Figure 8.5 (b) : 
QPainter painter(this) ; 

painter. setRenderHint(QPainter: Antialiasing, true) ; 

painter. setPen(QPen(Qt: :black, 15, Qt : :SolidLine, Qt: :RoundCap, 

Qt: :MiterJoin) ) ; 
painter. setBrush (QBrush (Qt : : blue, Qt : :DiagCrossPattern) ) ; 
painter. drawPie(80, 80, 400, 240, 60 * 16, 270 * 16); 

Les deux derniers arguments de drawPie ( ) sont exprimes en seiziemes de degre. 
Voici le code permettant de tracer la courbe de Bezier illustree en Figure 8.5 (c) : 

QPainter painter(this) ; 

painter. setRenderHint(QPainter: Antialiasing, true) ; 

QPainterPath path; 
path.moveTo(80, 320); 

path.cubicTo(200, 80, 320, 80, 480, 320); 

painter. setPen (QPen (Qt: : black, 8) ) ; 
painter. drawPath(path) ; 



La classe QPainterPath peut specifier des formes vectorielles arbitraires en regroupant des 
elements graphiques de base : droites, ellipses, polygones, arcs, courbes de Bezier cubiques et 



Chapitre 8 



Graphiques 2D et 3D 1 87 



quadratiques et autres traces de dessin. Les traces de dessin constituent la primitive graphique 
ultime, dans le sens ou on peut designer toute forme ou toute combinaison de formes par le 
terme de trace. 

Un trace specifie un contour, et la zone decrite par le contour peut etre remplie a l'aide d'un 
pinceau. Dans l'exemple de la Figure 8.5 (c), nous n'avons pas utilise de pinceau, seul le contour 
est done dessine. 

Les trois exemples precedents utilisent des modeles de pinceau integres (Qt : : SolidPattern, 
Qt : : DiagCrossPattern et Qt : : NoBrush). Dans les applications modernes, les remplissages 
degrades representent une alternative populaire aux remplissages monochromes. Les degrades 
reposent sur une interpolation de couleur permettant d'obtenir des transitions homogenes entre 
deux ou plusieurs couleurs. lis sont frequemment utilises pour produire des effets 3D ; par 
exemple, le style Plastique se sert des degrades pour afficher des QPushButton. 

Qt prend en charge trois types de degrades : lineaire, conique et circulaire. L'exemple Oven 
Timer dans la section suivante combine les trois types de degrades dans un seul widget pour le 
rendre plus reel. 

• Les degrades lineaires sont definis par deux points de controle et par une serie "d' arrets 
couleur" sur la ligne qui relie ces deux points. Par exemple, le degrade lineaire de la 
Figure 8.6 est cree avec le code suivant : 

QLinearGradient gradient(50, 100, 300, 350); 



gradient. setColorAt (0.0, Qt 
gradient. setColorAt(0. 2, Qt 
gradient. setColorAt(1 .0, Qt 



: white) ; 
:green) ; 
:black) ; 



Figure 8.6 

Les pinceaux degrades 
de QPainter 



(x v y,) 



(x 2 , y 2 ) 




\ (xjy c ) 




QLinearGradient 



QRadialGradient 



QRadialGradient 



Nous specifions trois couleurs a trois positions differentes entre les deux points de controle. 
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Les positions sont indiquees comme des valeurs a virgule flottante entre 0 et 1, oil 0 corres- 
pond au premier point de controle et 1 au second. Les couleurs situees entre les interruptions 
specifiers sont interpolees. 

• Les degrades circulaires sont definis par un centre (x a yj, un rayon r et une focale (jc„ y f ), 
en complement des interruptions de degrade. Le centre et le rayon specifient un cercle. Les 
couleurs se diffusent vers l'exterieur a partir de la focale, qui peut etre le centre ou tout 
autre point dans le cercle. 

• Les degrades coniques sont definis par un centre (jc c , y c ) et un angle OC. Les couleurs se 
diffusent autour du point central comme la trajectoire de la petite aiguille d'une montre. 

Jusqu'a present, nous avons mentionne les parametres de crayon, de pinceau et de police de 
QPainter. En plus de ceux-ci, QPainter propose d'autres parametres qui influencent la facon 
dont les formes et le texte sont dessines : 

• Le pinceau de fond est utilise pour remplir le fond des formes geometriques (sous le 
modele de pinceau), du texte ou des bitmaps quand le mode arriere-plan est configure en 
Qt : : OpaqueMode (la valeur par defaut est Qt : : TransparentMode). 

• L'origine du pinceau correspond au point de depart des modeles de pinceau, normalement 
le coin superieur gauche du widget. 

• La zone d'action est la zone du peripherique de dessin qui peut etre peinte. Dessiner en 
dehors de cette zone n'a aucun effet. 

• Le viewport, la fenetre et la matrice "world" determinent la maniere dont les coordonnees 
logiques de QPainter correspondent aux coordonnees physiques du peripherique de dessin. 
Par defaut, celles-ci sont definies de sorte que les systemes de coordonnees logiques et 
physiques coincident. Les systemes de coordonnees sont abordes dans la prochaine section. 

• Le mode de composition specifie comment les pixels qui viennent d'etre dessines doivent 
interagir avec les pixels deja presents sur le peripherique de dessin. La valeur par defaut est 
"source over," ou les pixels sont dessines au-dessus des pixels existants. Ceci n'est pris en 
charge que sur certains peripheriques et est traite ulterieurement dans ce chapitre. 

Vous pouvez sauvegarder l'etat courant d'un module de rendu nomme painter a tout moment 
sur une pile interne en appelant save ( ) et en le restaurant plus tard en invoquant restore () . 
Cela permet par exemple de changer temporairement certains parametres, puis de les reinitialiser a 
leurs valeurs anterieures, comme nous le verrons dans la prochaine section. 



Transformations du painter 

Avec le systeme de coordonnees par defaut du QPainter, le point (0, 0) se situe dans le coin 
superieur gauche du peripherique de dessin ; les coordonnees x augmentent vers la droite et les 
coordonnees y sont orientees vers le has. Chaque pixel occupe une zone d'une taille de 1 X 1 
dans le systeme de coordonnees par defaut. 
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II est important de comprendre que le centre d'un pixel se trouve aux coordonnees d'un "demi 
pixel". Par exemple, le pixel en haut a gauche couvre la zone entre les points (0, 0) et (1, 1) et 
son centre se trouve a (0,5, 0,5). Si nous demandons a QPainter de dessiner un pixel a (100, 
100) par exemple, il se rapprochera du resultat en decalant les coordonnees de +0,5 dans les 
deux sens, le pixel sera ainsi centre sur le point (100,5, 100,5). 

Cette distinction peut sembler plutot academique de prime abord, mais elle presente des conse- 
quences importantes en pratique. Premierement, le decalage de +0,5 ne se produit que si l'anti- 
crenelage est desactive (par defaut) ; si l'anticrenelage est active et si nous essayons de 
dessiner un pixel a (100, 100) en noir, QPainter colorier a les quatre pixels (99,5, 99,5), (99,5, 
100,5), (100,5, 99,5) et (100,5, 100,5) en gris clair pour donner l'impression qu'un pixel se 
trouve exactement au point de rencontre de ces quatre pixels. Si cet effet ne vous plait pas, 
vous pouvez l'eviter en specifiant les coordonnees d'un demi pixel, par exemple, (100,5, 
100,5). 

Lorsque vous tracez des formes comme des lignes, des rectangles et des ellipses, des regies 
similaires s'appliquent. La Figure 8.7 vous montre comment le resultat d'un appel de 
drawRect (2 , 2, 6, 5) varie en fonction de la largeur du crayon quand l'anticrenelage est 
desactive. II est notamment important de remarquer qu'un rectangle de 6 X 5 dessine avec une 
largeur de crayon de 1 couvre en fait une zone de 7X6. C'est different des anciens kits 
d'outils, y compris des versions anterieures de Qt, mais c'est essentiel pour pouvoir dessiner 
des images vectorielles reellement ajustables et independantes de la resolution. 

(0,0) 



(0 




Pas de crayon Largeur de Largeur de Largeur de 

crayon 1 crayon 2 crayon 3 



Figure 8.7 

Dessiner un rectangle de 6X5 sans anticrenelage 

Maintenant que nous avons compris le systeme de coordonnees par defaut, nous pouvons nous 
concentrer davantage sur la maniere de le modifier en utilisant le viewport, la fenetre et la 
matrice world de QPainter. (Dans ce contexte, le terme de "fenetre" ne se refere pas a une 
fenetre au sens de widget de niveau superieur, et le "viewport" n'a rien a voir avec le viewport 
de QScrollArea.) 

Le viewport et la fenetre sont etroitement lies. Le viewport est un rectangle arbitraire specifie 
en coordonnees physiques. La fenetre specifie le meme rectangle, mais en coordonnees logiques. 
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Au moment du trace, nous indiquons des points en coordonnees logiques qui sont converties en 
coordonnees physiques de maniere algebrique lineaire, en fonction des parametres actuels de la 
fenetre et du viewport. 

Par defaut, le viewport et la fenetre correspondent au rectangle du peripherique. Par exemple, 
si ce dernier est un widget de 320 X 200, le viewport et la fenetre representent le meme rectan- 
gle de 320 X 200 avec son coin superieur gauche a la position (0, 0). Dans ce cas, les systemes 
de coordonnees logiques et physiques sont identiques. 

Le mecanisme fenetre-viewport est utile pour que le code de dessin soit independant de la 
taille ou de la resolution du peripherique de dessin. Par exemple, si nous voulons que les coor- 
donnees logiques s'etendent de (-50, -50) a (+50, +50) avec (0, 0) au milieu, nous pouvons 
configurer la fenetre comme suit : 

painter. setWindow(-50, -50, 100, 100); 



La paire (-50, -50) specifie l'origine et la paire (100, 100) indique la largeur et la hauteur. 
Cela signifie que les coordonnees logiques (-50, -50) correspondent desormais aux coordon- 
nees physiques (0, 0), et que les coordonnees logiques (+50, +50) correspondent aux coor- 
donnees physiques (320, 200) (voir Figure 8.8). Dans cet exemple, nous n'avons pas modifie 
le viewport. 



(-50, -50) 



(0,0) 



(-30, -20) 



(+10, +20) 



fenetre 




viewport 



(320 ,200) 



Figure 8.8 

Convertir des coordonnees logiques en coordonnees physiques 



Venons-en a present a la matrice world. La matrice world est une matrice de transformation qui 
s' applique en plus de la conversion fenetre-viewport. Elle nous permet de translater, mettre a 
l'echelle, pivoter et faire glisser les elements que nous dessinons. Par exemple, si nous voulions 
dessiner un texte a un angle de 45°, nous utiliserions ce code : 

QMatrix matrix; 
matrix. rotate(45.0) ; 
painter. setMatrix(matrix) ; 

painter. drawText(rect, Qt : :AlignCenter, tr( "Revenue" )) ; 



Les coordonnees logiques transmises a drawText ( ) sont transformees par la matrice world, 
puis mappees aux coordonnees physiques grace aux parametres fenetre-viewport. 
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Si nous specifions plusieurs transformations, elles sont appliquees dans l'ordre dans lequel 
nous les avons indiquees. Par exemple, si nous voulons utiliser le point (10, 20) comme pivot 
pour la rotation, nous pouvons translater la fenetre, accomplir la rotation, puis translater a 
nouveau la fenetre vers sa position d'origine : 

QMatrix matrix; 

matrix. translate (-10.0, -20.0); 
matrix. rotate(45.0) ; 
matrix. translate(+10.0, +20.0); 
painter. setMatrix (matrix) ; 

painter. drawText(rect, Qt : :AlignCenter, tr("Revenue" 



II existe un moyen 
translate( ), sea 



plus simple de specifier des transformations : exploiter les fonctions pratiques 
ale( ), rotate( ) et shear( ) de QPainter : 

painter. translate(-10.0, -20.0); 

painter. rotate(45.0) ; 

painter. translate(+10.0, +20.0); 

painter. drawText(rect, Qt : :AlignCenter, tr( "Revenue" )) ; 

Cependant, si nous voulons appliquer les memes transformations de facon repetitive, il est plus 
efficace de les stocker dans un objet QMatrix et de configurer la matrice world sur le painter 
des que les transformations sont necessaires. 

Figure 8.9 

Le widget OvenTimer 




Pour illustrer les transformations du painter, nous allons analyser le code du widget OvenTimer 
presente en Figure 8.9. Ce widget est concu d'apres les minuteurs de cuisine que nous utili- 
sions avant que les fours soient equipes d'horloges integrees. L'utilisateur peut cliquer sur un cran 
pour definir la duree. La molette tournera automatiquement dans le sens inverse des aiguilles 
d'une montre jusqu'a 0, e'est a ce moment-la que OvenTimer emettra le signal timeout ( ). 

class OvenTimer : public QWidget 
{ 

Q_0BJECT 
public: 

OvenTimer (QWidget *parent = 0); 



void setDurationfint sees); 
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int duration( ) const; 

void draw(QPainter *painter); 

signals: 

void timeout () ; 

protected: 

void paintEventfQPaintEvent *event); 
void mousePressEvent(QMouseEvent *event); 

private: 

QDateTime finishTime; 
QTimer *updateTimer; 
QTimer *f inishTimer; 

}; 

La classe OvenTimer herite de QWidget et reimplemente deux fonctions virtuelles : paint- 
Event() et mousePressEvent ( ). 

const double DegreesPerMinute = 7.0; 

const double DegreesPerSecond = DegreesPerMinute / 60; 

const int MaxMinutes = 45; 

const int MaxSeconds = MaxMinutes * 60; 

const int Updatelnterval = 1; 

Nous definissons d'abord quelques constantes qui controlent 1' aspect et l'apparence du minuteur 
de four. 

OvenTimer: : OvenTimer (QWidget *parent) 
: QWidget (parent) 

{ 

finishTime = QDateTime: :currentDateTime() ; 
updateTimer = new QTimer(this) ; 

connect(updateTimer, SIGNAL(timeout() ) , this, SLOT(update( ) ) ) ; 

f inishTimer = new QTimer(this) ; 
f inishTimer- >setSingleShot ( true) ; 

connect(finishTimer, SIGNAL(timeout( ) ) , this, SIGNAL (timeout ()) ) ; 
connect (f inishTimer, SIGNAL(timeout( ) ) , updateTimer, SL0T(stop( ) ) ) ; 

} 

Dans le constructeur, nous creons deux objets QTimer : updateTimer est employe pour actuali- 
ser l'apparence du widget toutes les secondes, et finishTimer emet le signal timeout() du 
widget quand le minuteur du four atteint 0. finishTimer ne doit minuter qu'une seule fois, nous 
appelons done setSingleShot(true) ; par defaut, les minuteurs se declenchent de maniere repe- 
tee jusqu'a ce qu'ils soient stoppes ou detruits. Le dernier appel de connect() permet d'arreter 
la mise a jour du widget chaque seconde quand le minuteur est inactif . 

void OvenTimer: :setDuration(int sees) 
{ 

if (sees > MaxSeconds) { 
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sees = MaxSeconds; 
} else if (sees <= 0) { 
sees = 0; 

} 

finishTime = QDateTime: :currentDateTime() .addSecs(secs) ; 

if (sees > 0) { 

updateTimer->start(UpdateInterval * 1000); 

finishTimer->start(secs * 1000); 
} else { 

updateTimer->stop( ) ; 

f inishTimer->stop( ) ; 

} 

update( ) ; 

} 

La fonction setDu ration ( ) definit la duree du minuteur du four en nombre donne de secondes. 
Nous calculons l'heure de fin en ajoutant la duree a l'heure courante (obtenue a partir de 
QDateTime : : currentDateTime ( )) et nous la stockons dans la variable privee f inishTime. 
Nous finissons en invoquant update ( ) pour redessiner le widget avec la nouvelle duree. 

La variable f inishTime est de type QDateTime. Vu que la variable contient une date et une 
heure, nous evitons ainsi tout bogue lorsque l'heure courante se situe avant minuit et l'heure de 
fin apres minuit. 

int OvenTimer: :duration( ) const 
{ 

int sees = QDateTime: : currentDateTime () .secsTo(f inishTime) ; 
if (sees < 0) 
sees = 0; 
return sees; 

} 

La fonction duration ( ) retourne le nombre de secondes restantes avant que le minuteur ne 
s'arrete. Si le minuteur est inactif, nous retournons 0. 

void OvenTimer: :mousePressEvent(QMouseEvent *event) 
{ 

QPointF point = event->pos() - rect() .center() ; 

double theta = atan2(-point .x( ) , -point. y()) * 180 / 3.14159265359; 

setDuration(duration( ) + int(theta / DegreesPerSecond) ) ; 

update( ) ; 

} 

Si l'utilisateur clique sur le widget, nous recherchons le cran le plus proche grace a une 
formule mathematique subtile mais efficace, et nous utilisons le resultat pour definir la 
nouvelle duree. Puis nous planifions un reaffichage. Le cran sur lequel l'utilisateur a clique 
sera desormais en haut et se deplacera dans le sens inverse des aiguilles d'une montre au fur et 
a mesure que le temps s'ecoule jusqu'a atteindre 0. 



194 Qt4etC++ : Programmation d'interfaces GUI 



void OvenTimer: :paintEvent(QPaintEvent * /* event */) 
{ 

QPainter painter(this) ; 

painter. setRenderHint(QPainter: Antialiasing , true) ; 
int side = qMin (width () , height()); 

painter. setViewport( (width ( ) - side) / 2, (height () - side) / 2, 

side, side); 
painter. setWindow(-50, -50, 100, 100); 

draw(&painter) ; 

} 

Dans paintEvent ( ) , nous definissons le viewport de sorte qu'il devienne le carre le pus grand 
qui peut entrer dans le widget et nous definissons la fenetre en rectangle (-50, -50, 100, 100), 
c'est-a-dire le rectangle de 100 _ 100 allant de (-50, -50) a (+50, +50). La fonction modele 
qMin ( ) retourne le plus bas de ses deux arguments. Nous appelons ensuite la fonction draw( ) 
qui se chargera du dessin. 



Figure 8.10 

Le widget OvenTimer 
en trois tallies differentes 




Si nous n'avions pas defini le viewport en carre, le minuteur du four se transformerait en 
ellipse quand le widget serait redimensionne en rectangle (non carre). Pour eviter de telles 
deformations, nous devons configurer le viewport et la fenetre en rectangles ayant le meme 
format d'image. 

Analysons a present le code de dessin : 

void OvenTimer: :draw(QPainter *painter) 
{ 

static const int triangle[3] [2] = { 
{ -2, -49 }, { +2, -49 }, { 0, -47 } 

}; 

QPen thickPen(palette() .foreground(), 1.5); 
QPen thinPen(palette( ) .foreground( ) , 0.5); 
QColor niceBlue(150, 150, 200); 
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painter->setPen(thinPen) ; 
painter->setBrush ( palette ( ) .f oreground( ) ) ; 
painter->drawPolygon(QPolygon(3, &triangle[0] [0] ) ) ; 

Nous commencons par dessiner le petit triangle qui symbolise la position 0 en haut du widget. 
Le triangle est specifie par trois coordonnees codees et nous utilisons drawPolygon ( ) pour 
l'afficher. 

L' aspect pratique du mecanisme fenetre-viewport, c'est que nous avons la possibility de coder 
les coordonnees utilisees dans les commandes de dessin et de toujours obtenir un bon compor- 
tement lors du redimensionnement. 

QConicalGradient coneGradient(0, 0, -90.0); 
coneGradient.setColorAt(0.0, Qt: :darkGray) ; 
coneGradient.setColorAt(0.2, niceBlue) ; 
coneGradient.setColorAt(0.5, Qt: :white) ; 
coneGradient.setColorAt(1 .0, Qt: :darkGray) ; 

painter- >set Brush (coneGradient) ; 
painter->drawEllipse(-46, -46, 92, 92); 

Nous tracons le cercle exterieur et nous le remplissons avec un degrade conique. Le centre du 
degrade se trouve a la position (0, 0) et son angle est de -90°. 

QRadialGradient haloGradient(0, 0, 20, 0, 0); 
haloGradient.setColorAt(0.0, Qt: :lightGray); 
haloGradient.setColorAt(0.8, Qt: :darkGray) ; 
haloGradient.setColorAt(0.9, Qt: :white) ; 
haloGradient.setColorAt(1 .0, Qt: :black) ; 

painter->setPen(Qt: :NoPen) ; 
painter- >set Brush (haloGradient) ; 
painter->drawEllipse(-20, -20, 40, 40); 

Nous nous servons d'un degrade radial pour le cercle interieur. Le centre et la focale du 
degrade se situent a (0, 0). Le rayon du degrade est egal a 20. 

QLinearGradient knobGradient(-7, -25, 7, -25); 
knobGradient.setColorAt(0.0, Qt: :black) ; 
knobGradient.setColorAt(0.2, niceBlue) ; 
knobGradient.setColorAt(0.3, Qt: :lightGray) ; 
knobGradient.setColorAt(0.8, Qt: :white) ; 
knobGradient.setColorAt(1 .0, Qt: :black) ; 

painter->rotate(duration() * DegreesPerSecond) ; 
painter- >set Brush (knobGradient) ; 
painter->setPen(thinPen) ; 

painter->drawRoundRect(-7, -25, 14, 50, 150, 50); 

for (int i = 0; i <= MaxMinutes; ++i) { 
if (i % 5 == 0) { 
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painter->setPen(thickPen) ; 
painter->drawLine(0, -41, 0, -44); 
painter->drawText(-15, -41, 30, 25, 

Qt: :AlignHCenter | Qt : :AlignTop, 

QString: :number(i) ) ; 

} else { 

painter->setPen(thinPen) ; 
painter->drawLine(0, -42, 0, -44); 

} 

painter->rotate(-DegreesPerMinute) ; 

} 

} 

Nous appelons rotate () pour faire pivoter le systeme de coordonnees du painter. Dans 
l'ancien systeme de coordonnees, la marque correspondant a 0 minute se trouvait en haut ; 
maintenant, elle se deplace vers l'endroit approprie pour le temps restant. Nous dessinons le 
bouton rectangulaire apres la rotation, parce que son orientation depend de Tangle de cette 
rotation. 

Dans la boucle for, nous dessinons les graduations tout autour du cercle exterieur et les 
nombres pour chaque multiple de 5 minutes. Le texte est dessine dans un rectangle invisible en 
dessous de la graduation. A la fin de chaque iteration, nous faisons pivoter le painter dans le 
sens des aiguilles d'une montre de 7°, ce qui correspond a une minute. La prochaine fois que 
nous dessinons une graduation, elle sera a une position differente autour du cercle, meme si les 
coordonnees transmises aux appels de drawLine ( ) et drawText ( ) sont toujours les memes. 

Le code de la boucle for souffre d'un defaut mineur qui deviendrait rapidement apparent si 
nous effectuions davantage d'iterations. A chaque fois que nous appelons rotate (), nous 
multiplions la matrice courante par une matrice de rotation, engendrant ainsi une nouvelle 
matrice world. Les problemes d'arrondis associes a l'arithmetique en virgule flottante entrai- 
nent une matrice world tres imprecise. Voici un moyen de reecrire le code pour eviter ce 
probleme, en executant save() et restore () pour sauvegarder et recharger la matrice de 
transformation originale pour chaque iteration : 

for (int i = 0; i <= MaxMinutes; ++i) { 
painter->save( ) ; 

painter->rotate(-i * DegreesPerMinute) ; 

if (i % 5 == 0) { 

painter->setPen(thickPen) ; 
painter->drawLine(0, -41, 0, -44); 
painter->drawText(-15, -41, 30, 25, 

Qt: :AlignHCenter | Qt : :AlignTop, 

QString: :number(i) ) ; 

} else { 

painter->setPen(thinPen) ; 
painter->drawLine(0, -42, 0, -44); 

} 

painter->restore() ; 

} 
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II existe un autre moyen d'implementer un minuteur de four : calculer les positions (x, y) soi- 
meme, en utilisant sin() et cos() pour trouver les positions autour du cercle. Mais nous 
aurions encore du employer une translation et une rotation pour dessiner le texte a un certain 
angle. 

Affichage de haute qualite avec Qlmage 

Au moment de dessiner, vous pourriez avoir a trouver un compromis entre vitesse et precision. 
Par exemple, sous XI 1 et Mac OS X, le dessin sur un QWidget ou un QPixmap repose sur le 
moteur de dessin natif de la plate-forme. Sous XI 1, ceci reduit au maximum les communica- 
tions avec le serveur X ; seules les commandes de dessin sont envoyees plutot que les donnees 
de l'image. Le principal inconvenient de cette approche, c'est que le champ d'action de Qt est 
limite a celui de la prise en charge native de la plate -forme : 

• Sous XI 1, des fonctionnalites, telles que l'anticrenelage et le support des coordonnees 
fractionnaires, ne sont disponibles que si l'extension X Render se trouve sur le serveur X. 

• Sous Mac OS X, le moteur graphique natif crenele s'appuie sur des algorithmes differents 
pour dessiner des polygones par rapport a XI 1 et Windows, avec des resultats legerement 
differents. 

Quand la precision est plus importante que l'efficacite, nous pouvons dessiner un Qlmage et 
copier le resultat a l'ecran. Celui-ci utilise toujours le moteur de dessin interne de Qt, aboutis- 
sant ainsi a des resultats identiques sur toutes les plates-formes. La seule restriction, c'est que 
le Qlmage, sur lequel nous dessinons, doit etre cree avec un argument de type 
Qlmage: : Format_RGB32 ou Qlmage : : Format_ARGB32_Premultiplied. 

Le format ARGB32 premultiplie est presque identique au format traditionnel ARGB32 
(Oxaarrggbb), a la difference pres que les canaux rouge, vert et bleu sont "pre multiplies" par 
le canal alpha. Cela signifie que les valeurs RVB, qui s'etendent normalement de 0x00 a 0xFF, 
sont mises a l'echelle de 0x00 a la valeur alpha. Par exemple, une couleur bleue transparente a 
50 % est representee par 0X7F0000FF en format ARGB32, mais par 0X7F00007F en format 
ARGB32 premultiplie. De meme, une couleur vert fonce transparente a 75 % representee par 
0X3F008000 en format ARGB32 deviendrait 0X3F002000 en format ARGB32 premultiplie. 

Supposons que nous souhaitons utiliser l'anticrenelage pour dessiner un widget et que nous 
voulons obtenir de bons resultats meme sous des systemes XI 1 sans l'extension X Render. 
Voici la syntaxe du gestionnaire paintEvent() d'origine, qui se base sur X Render pour 
l'anticrenelage : 

void MyWidget: :paintEvent(QPaintEvent *event) 
{ 

QPainter painter(this) ; 

painter. setRenderHint(QPainter: : Antialiasing, true) ; 
draw(&painter) ; 

} 
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Voila comment reecrire la fonction paintEvent() du widget pour exploiter le moteur graphique 
de Qt independant de la plate-forme : 

void MyWidget: :paintEvent(QPaintEvent *event) 
{ 

Qlmage image(size( ) , Qlmage: : Format_ARGB32_Premultiplied) ; 
QPainter imagePainter(&image) ; 
imagePainter.initFrom(this) ; 

imagePainter.setRenderHint(QPainter: : Antialiasing, true) ; 
imagePainter.eraseRect (rect ( ) ) ; 
draw(&imagePainter) ; 
imagePainter.end() ; 

QPainter widgetPainter(this) ; 
widgetPainter.drawImage(0, 0, image); 

} 

Nous creons un Qlmage de la meme taille que le widget en format ARGB32 premultiplie, et un 
QPainter pour dessiner sur l'image. L'appel de initFrom ( ) initialise le crayon, le fond et la 
police en fonction du widget. Nous effectuons notre dessin avec QPainter comme d' habitude, 
et a la fin, nous reutilisons l'objet QPainter pour copier l'image sur le widget. 

Cette approche produit d'excellents resultats identiques sur toutes les plates-formes, a l'exception 
de l'affichage de la police qui depend des polices installees. 

Une fonctionnalite particulierement puissante du moteur graphique de Qt est sa prise en charge 
des modes de composition. Ceux-ci specifient comment un pixel source et un pixel de destina- 
tion fusionnent pendant le dessin. Ceci s'applique a toutes les operations de dessin, y compris 
le crayon, le pinceau, le degrade et l'image. 

Le mode de composition par defaut est Qlmage: : CompositionMode_SourceOver, ce qui 
signifie que le pixel source (celui que nous dessinons) remplace le pixel de destination (le pixel 
existant) de telle maniere que le composant alpha de la source definit sa translucidite. Dans la 
Figure 8.11, vous voyez un papillon a moitie transparent dessine sur un motif a damiers avec 
les differents modes. 

Figure 8.11 ■ ■ ■ . . 
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Les modes de composition sont definis a l'aide de QPainter: :setCompositionMode( ). Par 
exemple, voici comment creer un Qlmage qui combine en XOR le papillon et le motif a damiers : 
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Qlmage resultlmage = checkerPatternlmage; 
QPainter painter(&resultlmage) ; 

painter. setCompositionMode (QPainter: :CompositionMode_Xor) ; 
painter. drawlmage(0, 0, butterf lylmage) ; 

II faut etre conscient du probleme lie au fait que l'operation Qlmage :: Compo- 
sitionMode_Xor s'applique au canal alpha. Cela signifie que si nous appliquons XOR (OU 
exclusif) a la couleur blanche (OxFFFFFFFF), nous obtenons une couleur transparente 
(0x00000000), et pas noire (0xFF000000). 



Impression 

L'impression dans Qt est equivalente au dessin sur QWidget, QPixmap ou Qlmage. Plusieurs 
etapes sont necessaires : 

1. creer un QPrinter qui fera office de peripherique de dessin ; 

2. ouvrir un QPrintDialog, qui permet a l'utilisateur de choisir une imprimante et de confi- 
gurer certaines options ; 

3. creer un QPainter pour agir sur le QPrinter ; 

4. dessiner une page a l'aide de QPainter ; 

5. appeler QPrinter : :newPage() pour passer a la page suivante ; 

6. repeter les etapes 4 et 5 jusqu'a ce que toutes les pages soient imprimees. 

Sous Windows et Mac OS X, QPrinter utilise les pilotes d'imprimante du systeme. Sous 
Unix, il genere un PostScript et l'envoie a lp ou lpr (ou au programme defini en executant 
QPrinter : : setPrintProgram( )). QPrinter peut aussi servir a generer des fichiers PDF en 
appelant setOutputFormat (QPrinter : : Pdf Format ). 

Commencons par quelques exemples simples qui s'impriment tous sur une seule page. Le premier 
exemple imprime un QImage(voir Figure 8.12) : 

void PrintWindow: :printImage(const Qlmage Simage) 
{ 

QPrintDialog printDialog(&printer, this); 
if (printDialog.exec( ) ) { 

QPainter painter(&printer) ; 

QRect rect = painter. viewportf) ; 

QSize size = image. size ( ) ; 

size. scale (rect. size () , Qt: :KeepAspectRatio) ; 

painter. setViewport(rect.x() , rect.y() , 

size. width () , size. height ()) ; 

painter. setWindowf image. rect ( ) ) ; 

painter. drawlmage(0, 0, image); 

} 

} 
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Nous supposons que la classe PrintWindow possede une variable membre appelee printer 
de type QPrinter. Nous aurions simplement pu creer QPrinter sur la pile dans print- 
Image ( ) , mais les parametres de l'utilisateur auraient ete perdus entre deux impressions. 

Nous creons un QPrintDialog et nous invoquons exec ( ) pour l'afficher. II retourne true si 
l'utilisateur a clique sur le bouton OK ; sinon il retourne false. Apres l'appel de exec(), 
l'objet QPrinter est pret a etre utilise. (II est aussi possible d'imprimer sans utiliser QPrin- 
tDialog, en appelant directement des fonctions membres de QPrinter pour configurer les 
divers aspects.) 

Nous creons ensuite un QPainter pour dessiner sur le QPrinter. Nous definissons la fenetre 
en rectangle de 1' image et le viewport en un rectangle du me me format d' image, puis nous 
dessinons l'image a la position (0, 0). 

Par defaut, la fenetre de QPainter est initialisee de sorte que 1'imprimante semble avoir une 
resolution similaire a l'ecran (en general entre 72 et 100 points par pouce), ce qui facilite la 
reutilisation du code de dessin du widget pour l'impression. Ici, ce n'etait pas un probleme, 
parce que nous avons defini notre propre fenetre. 

Imprimer des elements qui ne s'etendent pas sur plus d'une page se revele tres simple, mais 
de nombreuses applications ont besoin d'imprimer plusieurs pages. Pour celles-ci, nous 
devons dessiner une page a la fois et appeler newPage( ) pour passer a la page suivante. 
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Ceci souleve un probleme : determiner la quantite d' informations que nous pouvons impri- 
mer sur chaque page. II existe deux approches principales pour gerer les documents multipages 
avec Qt : 

• Nous pouvons convertir nos donnees en format HTML et les afficher avec QTextDocument, le 
moteur de texte de Qt. 

• Nous pouvons effectuer le dessin et la repartition sur les pages manuellement. 

Nous allons analyser les deux approches. En guise d'exemple, nous allons imprimer un guide 
des fleurs : une liste de noms de fleurs, chacun comprenant une description sous forme de 
texte. Chaque entree du guide est stockee sous forme de chaine au format "nom: description," 
par exemple : 

Miltonopsis santanae: une des especes d 1 orchidees les plus dangereuses. 

Vu que les donnees relatives a chaque fleur sont representees par une seule chaine, nous 
pouvons representer toutes les fleurs dans le guide avec un QSt ring List. Voici la fonction qui 
imprime le guide des fleurs au moyen du moteur de texte de Qt : 

void PrintWindow: :printFlowerGuide (const QStringList Sentries) 
{ 

QString html; 

foreach (QString entry, entries) { 

QStringList fields = entry. split( " : "); 
QString title = Qt: :escape(fields[0] ) ; 
QString body = Qt: :escape(fields[1 ] ) ; 

html += "<table width=\"100%\" border=1 cellspacing=0>\n" 
"<tr><td bgcolor=\ "lightgray\ "><font size=\ "+1 \ ">" 
"<b><i>" + title + "</i></b></font>\n<tr><td>" + body 
+ " \n</table>\n<br>\n" ; 

} 

printHtml(html) ; 

} 

La premiere etape consiste a convertir QSt ringList en format HTML. Chaque fleur est repre- 
sentee par un tableau HTML avec deux cellules. Nous executons Qt : : escape ( ) pour remplacer 
les caracteres speciaux "&", "<", ">" par les entites HTML correspondantes ("&", "<", 
">"). Nous appelons ensuite printHtml( ) pour imprimer le texte. 

void PrintWindow: :printHtml(const QString Shtml) 
{ 

QPrintDialog printDialog(&printer, this); 
if (printDialog.execf ) ) { 

QPainter painterj&printer) ; 

QTextDocument textDocument; 

textDocument.setHtml(html) ; 

textDocument. print(&printer) ; 

} 

} 
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La fonction printHtml() ouvre un QPrintDialog et se charge d'imprimer un document 
HTML. Elle peut etre reutilisee "telle quelle" dans n'importe quelle application Qt pour imprimer 
des pages HTML arbitraires. 



Figure 8.13 

Imprimer un guide 
desfleurs avec 
Q TextDocumen t 




Convertir un document au format HTML et utiliser QTextDocument pour 1'imprimer est de 
loin la methode la plus pratique pour imprimer des rapports et d'autres documents complexes. 
Des que vous avez besoin d'un niveau de controle superieur, vous pouvez envisager de gerer la 
mise en page et le dessin manuellement. Voyons maintenant comment nous pouvons utiliser 
cette approche pour imprimer le guide des fleurs (voir Figure 8.13). Voila la nouvelle fonction 
printFlowerGuide( ) : 

void PrintWindow: :printFlowerGuide (const QStringList Sentries) 
{ 

QPrintDialog printDialog(&printer, this); 
if (printDialog.exec( ) ) { 

QPainter painter(&printer) ; 

QList<QStringList> pages; 

paginate(&painter, &pages, entries); 
printPages(&painter , pages); 

} 

} 

Apres avoir configure l'imprimante et construit le painter, nous appelons la fonction pagi- 
nate ( ) pour determiner quelle entree doit apparaitre sur quelle page. Vous obtenez done une 
liste de QStringList, chacun contenant les entrees d'une page. Nous transmettons ce resultat 
a printPages( ). 
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Supposons, par exemple, que le guide des fleurs contient 6 entrees, que nous appellerons A, B, 
C, D, E et F. Imaginons maintenant qu'il y a suffisamment de place pour A et B sur la premiere 
page, pour C, D et E sur la deuxieme page et pour F sur la troisieme page. La liste pages 
contiendrait done la liste [A, B] a la position d'index 0, la liste [C, D, E] a la position 
d' index 1 et la liste [ F ] a la position d'index 2. 

void PrintWindow: :paginate(QPainter *painter, QList<QStringList> *pages, 

const QStringList Sentries) 

{ 

QStringList currentPage; 

int pageHeight = painter->window() .height () - 2 * LargeGap; 
int y = 0; 

foreach (QString entry, entries) { 

int height = entryHeight(painter, entry); 

if (y + height > pageHeight && !currentPage.empty( ) ) { 

pages->append(currentPage) ; 

currentPage. clear() ; 

y = 0; 

} 

currentPage. append(entry) ; 
y += height + MediumGap; 

} 

if ( 'currentPage. empty () ) 

pages->append(currentPage) ; 

} 

La fonction paginate ( ) repartit les entrees du guide des fleurs sur les pages. Elle se base sur 
la fonction entryHeight ( ) qui calcule la hauteur d'une entree. Elle tient egalement compte 
des espaces vides verticaux en haut et en bas de la page, de taille LargeGap. 

Nous parcourons les entrees et nous les ajoutons a la page en cours jusqu'a ce qu'une entree 
n'ait plus suffisamment de place sur cette page ; puis nous ajoutons la page en cours a la liste 
pages et nous commencons une nouvelle page. 

int PrintWindow: : entryHeight (QPainter *painter, const QString &entry) 
{ 

QStringList fields = entry. split)" : "); 
QString title = fields[0]; 
QString Pody = fields[1 ] ; 

int textWidth = painter->window( ) .width( ) - 2 * SmallGap; 
int maxHeight = painter->window( ) . height () ; 

painter->setFont(titleFont) ; 

QRect titleRect = painter->boundingRect(0, 0, textWidth, maxHeight, 

Qt: :TextWordWrap, title); 

painter->setFont(bodyFont) ; 

QRect bodyRect = painter->boundingRect(0, 0, textWidth, maxHeight, 

Qt: :TextWordWrap, body); 
return titleRect. height() + bodyRect. height ( ) + 4 * SmallGap; 

} 
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La fonction entryHeight ( ) se sert de QPainter: : boundingRect ( ) pour calculer l'espace 
vertical necessaire pour une entree. La Figure 8.14 presente la disposition d'une entree et la 
signification des constantes SmallGap et MediumGap. 



Figure 8.14 
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void PrintWindow: :printPages (QPainter *painter, 

const QList<QStringList> &pages) 

{ 

int firstPage = printer. fromPagef) - 1; 
if (firstPage >= pages. size()) 

return; 
if (firstPage == -1 ) 

firstPage = 0; 

int lastPage = printer. toPage() - 1; 
if (lastPage == -1 || lastPage >= pages. size()) 
lastPage = pages. size () - 1; 

int numPages = lastPage - firstPage + 1 ; 

for (int i = 0; i < printer . numCopies () ; ++i) { 
for (int j = 0; j < numPages; ++j) { 
if (i != 0 | | j != 0) 
printer. newPage() ; 

int index; 

if (printer. pageOrder() == QPrinter: :FirstPageFirst) { 

index = firstPage + j ; 
} else { 

index = lastPage - j ; 

} 

printPagefpainter, pages[index] , index +1); 

} 

} 

} 
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Le role de la fonction printPages( ) est d'imprimer chaque page a l'aide de printPage( ) 
dans le bon ordre et les bonnes quantites. Grace a QPrintDialog, l'utilisateur peut demander 
plusieurs copies, specifier une plage d'impression ou demander les pages en ordre inverse. 
C'est a nous d'honorer ces options - ou de les desactiver au moyen de QPrintDia- 
log: : setEnabledOptions( ). 

Nous determinons tout d'abord la plage a imprimer. Les fonctions f romPage ( ) et toPage ( ) 
de QPrinter retournent les numeros de page selectionnes par l'utilisateur, ou 0 si aucune 
plage n'a ete choisie. Nous soustrayons 1, parce que notre liste pages est indexee a partir de 0, 
et nous definissons f irstPage et lastPage de sorte a couvrir la totalite de la plage si l'utili- 
sateur n'a rien precise. 

Puis nous imprimons chaque page. La boucle externe for effectue une iteration autant de fois 
que necessaire pour produire le nombre de copies demande par l'utilisateur. La plupart des 
pilotes d'imprimante prennent en charge les copies multiples, QPrinter :: numCopies ( ) 
retourne toujours 1 pour celles-ci. Si le pilote ne peut pas gerer plusieurs copies, numCo- 
pies () renvoie le nombre de copies demande par l'utilisateur, et l'application se charge 
d'imprimer ce nombre de copies. (Dans l'exemple Qlmage precedent, nous avons ignore 
numCopies ( ) pour une question de simplicite.) 



Figure 8.15 

Imprimer un guide des 
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La boucle interne for parcourt les pages. Si la page n'est pas la premiere page, nous appelons 
newPage ( ) pour supprimer l'ancienne page de la memoire et pour commencer a dessiner sur 
une nouvelle page. Nous invoquons printPage ( ) pour dessiner chaque page. 

void PrintWindow: :printPage(QPainter *painter, 

const QStringList Sentries, int pageNumber) 

{ 

painter->save( ) ; 
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painter->translate(0, LargeGap); 
foreach (QString entry, entries) { 

QStringList fields = entry. split( " : "); 

QString title = fields[0]; 

QString body = fields! 1 ] ; 

printBox(painter, title, titleFont, Qt: :lightGray) ; 
printBox(painter, body, bodyFont, Qt::white); 
painter->translate(0, MediumGap) ; 

} 

painter->restore( ) ; 

painter->setFont(footerFont) ; 

painter->drawText (painter->window( ) , 

Qt: :AlignHCenter | Qt : :AlignBottom, 
QString: :number(pageNumber) ) ; 



La fonction printPage ( ) parcourt toutes les entrees du guide des fleurs et les imprime grace a 
deux appels de printBox( ) : un pour le titre (le nom de la fleur) et un pour le corps (sa 
description). Elle dessine egalement le numero de page centre au bas de la page (voir 
Figure 8.16). 



Figure 8.16 
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void PrintWindow: :printBox(QPainter *painter, const QString &str, 

const QFont &font, const QBrush &brush) 

{ 

painter->setFont(font) ; 

int boxWidth = painter->window( ) .width () ; 
int textWidth = boxWidth - 2 * SmallGap; 
int maxHeight = painter->window( ) . height () ; 
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QRect textRect = painter->boundingRect(SmallGap, SmallGap, 

textWidth, maxHeight, 
Qt: :TextWordWrap, str); 

int boxHeight = textRect. height () + 2 * SmallGap; 

painter->setPen(QPen(Qt: :black, 2, Qt: :SolidLine) ) ; 
painter->setBrush(brush) ; 
painter->drawRect(0, 0, boxWidth, boxHeight); 
painter->drawText (textRect, Qt: :TextWordWrap, str); 
painter->translate(0, boxHeight) ; 

} 

La fonction printBox ( ) trace les contours d'une boite, puis dessine le texte a l'interieur. 



Graphiques avec OpenGL 

OpenGL est une API standard permettant d'afficher des graphiques 2D et 3D. Les applications 
Qt peuvent tracer des graphiques 3D en utilisant le module QtOpenGL, qui se base sur la biblio- 
theque OpenGL du systeme. Cette section suppose que vous connaissez deja OpenGL. Si vous 
decouvrez OpenGL, consultez d'abord http://www.opengl.org/ pour en apprendre davantage. 



Figure 8.17 

L' application 
Tetrahedron 




Dessiner des graphiques avec OpenGL dans une application Qt se revele tres facile : vous 
devez deriver QGLWidget, reimplementer quelques fonctions virtuelles et relier l'appli- 
cation aux bibliotheques QtOpenGL et OpenGL. Etant donne que QGLWidget herite de 
QWidget, la majorite des notions que nous connaissons deja peuvent s'appliquer a ce cas. 
La principale difference c'est que nous utilisons des fonctions OpenGL standards pour dessiner 
en lieu et place de QPainter. 
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Pour vous montrer comment cela fonctionne, nous allons analyser le code de 1' application 
Tetrahedron presentee en Figure 8.17. L application presente un tetraedre en 3D, ou une 
matrice a quatre faces, chaque face ayant une couleur differente. Lutilisateur peut faire pivoter 
le tetraedre en appuyant sur un bouton de la souris et en le faisant glisser. II peut aussi definir la 
couleur d'une face en double-cliquant dessus et en choisissant une couleur dans le QColor- 
Dialog qui s'ouvre. 

class Tetrahedron : public QGLWidget 
{ 

Q_0BJECT 
public: 

Tetrahedron (QWidget *parent = 0); 

protected: 

void initializeGL( ) ; 

void resizeGL(int width, int height); 

void paintGL( ) ; 

void mousePressEvent(QMouseEvent *event); 

void mouseMoveEvent(QMouseEvent *event); 

void mouseDoubleClickEvent(QMouseEvent *event); 

private: 

void draw() ; 

int f aceAtPosition(const QPoint &pos); 

GLfloat rotationX; 
GLfloat rotationY; 
GLfloat rotationZ; 
QColor faceColors[4] ; 
QPoint lastPos; 

}; 

La classe Tetrahedron herite de QGLWidget. Les fonctions initializeGL ( ) , resizeGL( ) 
et paintGL( ) sont reimplementees dans QGLWidget. Les gestionnaires d'evenements mouse 
sont reimplementes dans QWidget comme d'habitude. 

Tetrahedron: : Tetrahedron (QWidget *parent) 
: QGLWidget(parent) 

{ 

setFormat(QGLFormat(QGL: :DoubleBuffer | QGL: :DepthBuffer) ) ; 
rotationX = -21 .0; 
rotationY = -57.0; 
rotationZ =0.0; 



f aceColors[0] 


= Qt: 


: red; 


faceColors[1 ] 


= Qt: 


:green; 


f aceColors[2] 


= Qt: 


:blue; 


f aceColors[3] 


= Qt: 


: yellow 



} 
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Dans le constructeur, nous appelons QGLWidget : : setFormat ( ) pour specifier le contexte 
d'affichage OpenGL et nous initialisons les variables privees de la classe. 

void Tetrahedron: :initializeGL() 
{ 

qglClearColor(Qt: :black) ; 
glShadeModel(GL_FLAT) ; 
glEnable (GL_DEPTH_TEST) ; 
glEnable (GL_CULL_FACE) ; 

} 

La fonction initialized- ( ) est invoquee une seule fois avant que paintGL( ) soit appelee. 
C'est done dans le code de cette fonction que nous allons configurer le contexte d'affichage 
OpenGL, definir les listes d'affichage et accomplir d'autres initialisations. 

Tout le code est en OpenGL standard, sauf l'appel de la fonction qglClearColor( ) de 
QGLWidget. Si nous voulions uniquement du code OpenGL standard, nous aurions pu appeler 
glClearColor ( ) en mode RGBA et glClear Index ( ) en mode table des couleurs. 

void Tetrahedron: : resizeGL(int width, int height) 
{ 

glViewport(0, 0, width, height); 
glMatrixMode(GL_PROJECTION) ; 
glLoadldentity ( ) ; 

GLfloat x = GLfloat (width) / height; 
glFrustum(-x, x, -1.0, 1.0, 4.0, 15.0); 
glMatrixMode(GL_MODELVIEW) ; 

} 

La fonction resizeGL() est invoquee avant le premier appel de paintGL(), mais apres 
l'appel de initializeGL( ). Elle est aussi invoquee des que le widget est redimensionne. 
C'est la que nous avons la possibility de configurer le viewport OpenGL, la projection et tout 
autre parametre qui depend de la taille du widget. 

void Tetrahedron: :paintGL() 
{ 

glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT) ; 
draw( ) ; 

} 

La fonction paintGL( ) est invoquee des que le widget doit etre redessine. Elle ressemble a 
QWidget : : paintEvent ( ), mais des fonctions OpenGL remplacent les fonctions de QPainter. 
Le dessin est effectue par la fonction privee draw( ). 

void Tetrahedron: :draw() 
{ 

static const GLfloat P1[3] = { 0.0, -1.0, +2.0 }; 

static const GLfloat P2[3] = { +1.73205081, -1.0, -1.0 }; 

static const GLfloat P3[3] = { -1.73205081, -1.0, -1.0 }; 

static const GLfloat P4[3] = { 0.0, +2.0, 0.0 }; 
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static const GLfloat * const coords[4] [3] = { 

{ P1, P2, P3 }, { P1, P3, P4 }, { P1, P4, P2 }, { P2, P4, P3 } 

}; 

glMatrixMode(GL_MODELVIEW) ; 
glLoadldentity ( ) ; 
glTranslatef (0.0, 0.0, -10.0); 
glRotatef (rotationX, 1.0, 0.0, 0.0); 
glRotatef (rotationY, 0.0, 1.0, 0.0); 
glRotatef (rotationZ, 0.0, 0.0, 1.0); 

for (int i = 0; i < 4; ++i) { 
glLoadName(i) ; 
glBegin (GL_TRIANGLES) ; 
qglColor(faceColors[i] ) ; 
for (int j = 0; j < 3; ++j) { 

glVertex3f (coords [i] [j ] [0] , coords [i] [ j ] [1 ] , 
coords[i][j][2]); 

} 

glEnd(); 

} 

} 

Dans draw(), nous dessinons le tetraedre, en tenant compte des rotations x, y et z et des 
couleurs conservees dans le tableau f aceColors. Tout est en code OpenGL standard, sauf 
l'appel de qglColor(). Nous aurions pu choisir plutot une des fonctions OpenGL 
glColor3d ( ) ou gllndex( ) en fonction du mode. 

void Tetrahedron: rmousePressEvent (QMouseEvent *event) 
{ 

lastPos = event->pos( ) ; 

} 

void Tetrahedron: :mouseMoveEvent(QMouseEvent *event) 
{ 

GLfloat dx = GLfloat(event->x() - lastPos. x()) / width(); 
GLfloat dy = GLf loat(event->y( ) - lastPos.yO) / height(); 

if (event->buttons() & Qt: :LeftButton) { 
rotationX += 180 * dy; 
rotationY += 180 * dx; 
updateGL() ; 

} else if (event->buttons( ) & Qt: :RightButton) { 
rotationX += 180 * dy; 
rotationZ += 180 * dx; 
updateGL() ; 

} 

lastPos = event->pos( ) ; 

} 

Les fonctions mousePressEvent ( ) et mouseMoveEvent ( ) sont reimplementees dans QWid- 
get pour permettre a l'utilisateur de faire pivoter la vue en cliquant dessus et en la faisant glisser. 
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Le bouton gauche de la souris controle la rotation autour des axes x et y, et le bouton droit 
autour des axes x et z- 

Apres avoir modifie la variable rotationX et une des variables rotationY ou rotationZ, 
nous appelons updateGL ( ) pour redessiner la scene. 

void Tetrahedron: :mouseDoubleClickEvent(QMouseEvent *event) 
{ 

int face = faceAtPosition(event->pos( ) ) ; 
if (face != -1) { 

QColor color = QColorDialog: :getColor(f aceColors[f ace] , this); 
if (color. isValidf)) { 

faceColors[face] = color; 
updateGLf ) ; 

} 

} 

} 

mouseDoubleClickEvent ( ) est reimplementee dans QWidget pour permettre a l'utilisateur 
de definir la couleur d'une des faces du tetraedre en double -cliquant dessus. Nous invoquons la 
fonction privee f aceAtPosition ( ) pour determiner quelle face se situe sous le curseur, s'il y en 
a une. Si l'utilisateur a double-clique sur une face, nous appelons QColorDialog : : getColor ( ) 
pour obtenir une nouvelle couleur pour cette face. Nous mettons ensuite a jour le tableau 
faceColors pour tenir compte de la nouvelle couleur et nous invoquons updateGL() pour 
redessiner la scene. 

int Tetrahedron: :faceAtPosition(const QPoint &pos) 
{ 

const int MaxSize = 512; 
GLuint buff er[MaxSize] ; 
GLint viewport[4] ; 

glGetIntegerv(GL_VIEWPORT, viewport) ; 
glSelectBuff er(MaxSize, buffer); 
glRenderMode(GL_SELECT); 

glInitNames( ) ; 
glPushName(0) ; 

glMatrixMode(GL_PROJECTION) ; 
glPushMatrixf ) ; 
glLoadldentity ( ) ; 

gluPickMatrix(GLdouble(pos.x( ) ) , GLdouble(viewport[3] - pos.y()), 

5.0, 5.0, viewport); 
GLfloat x = GLfloat(widthf)) / height(); 
glFrustum(-x, x, -1.0, 1.0, 4.0, 15.0); 
draw( ) ; 

glMatrixMode(GL_PROJECTION) ; 
glPopMatrix( ) ; 
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if ( !glRenderMode(GL_RENDER) ) 

return -1 ; 
return buff er[3] ; 

} 

La fonction f aceAtPosition ( ) retourne le nombre de faces a une certaine position sur le 
widget, ou -1 si aucune face ne se trouve a cet endroit. Le code OpenGL permettant de deter- 
miner ceci est quelque peu complexe. En resume, nous affichons la scene en mode GL_SELECT 
pour profiter des fonctionnalites de selection d' OpenGL, puis nous recuperons le numero de la 
face (son "nom") dans l'enregistrement du nombre d'acces d'OpenGL. 

Voici main . cpp : 

#include <QApplication> 
#include <iostream> 

#include "tetrahedron. h" 

using namespace std; 

int mainfint argc, char *argv[]) 
{ 

QApplication appfargc, argv); 
if (!QGLFormat::hasOpenGL()) { 

cerr « "This system has no OpenGL support" « endl; 

return 1 ; 

} 

Tetrahedron tetrahedron; 

tetrahedron .setWindowTitle(QObject : :tr( "Tetrahedron" ) ) ; 
tetrahedron . resize(300, 300); 
tetrahedron. show() ; 

return app.exec() ; 

} 

Si le systeme de l'utilisateur ne prend pas en charge OpenGL, nous imprimons un message 
d'erreur sur la console et nous retournons immediatement. 

Pour associer 1' application au module QtOpenGL et a la bibliotheque OpenGL du systeme, le 
fichier .pro doit contenir cette entree : 

QT += opengl 

L application Tetrahedron est terminee. Pour plus d' informations sur le module QtOpenGL, 
consultez la documentation de reference de QGLWidget, QGLFormat, QGLContext, QGLColor- 
map et QGLPixelBuf f er. 
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Au sommaire de ce chapitre 

^ Activer le glisser-deposer 

\/ Prendre en charge les types personnalises 
de glisser 

✓ Gerer le presse-papiers 



Le glisser-deposer est un moyen moderne et intuitif de transferer des informations dans 
une application ou entre differentes applications. Cette technique est souvent proposee 
en complement du support du presse-papiers pour deplacer et copier des donnees. 

Dans ce chapitre, nous verrons comment ajouter la prise en charge du glisser-deposer a 
une application et comment gerer des formats personnalises. Nous etudierons egalement 
la maniere de reutiliser le code du glisser-deposer pour ajouter le support du presse- 
papiers. Cette reutilisation du code est possible parce que les deux mecanismes sont 
bases sur QMimeData, une classe capable de fournir des donnees dans divers formats. 
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Activer le glisser-deposer 

Le glisser-deposer implique deux actions distinctes : glisser et deposer. On peut faire glisser et/ou 
deposer des elements sur les widgets Qt. 

Notre premier exemple vous presente comment faire accepter a une application Qt un glisser 
initie par une autre application. L' application Qt est une fenetre principale avec un widget 
central QTextEdit. Quand l'utilisateur fait glisser un fichier texte du bureau ou de l'explorateur 
de fichiers vers 1' application, celle-ci charge le fichier dans le QTextEdit . 

Voici la definition de la classe MainWindowde notre exemple : 

class MainWindow : public QMainWindow 
{ 

Q_0BJECT 

public: 

MainWindowf ) ; 

protected: 

void dragEnterEvent(QDragEnterEvent *event); 
void dropEvent(QDropEvent *event); 

private: 

bool readFile(const QString &fileName); 
QTextEdit TextEdit; 

}; 

La classe MainWindow reimplemente dragEnterEvent ( ) et dropEvent ( ) dans QWidget. Vu 
que l'objectif de notre exemple est de presenter le glisser-deposer, la majorite des fonctionnalites 
qu'une classe de fenetre principale devrait contenir a ete omise. 

MainWindow: :MainWindow( ) 
{ 

textEdit = new QTextEdit; 
setCentralWidget(textEdit) ; 

textEdit->setAcceptDrops (false) ; 
setAcceptDrops(true) ; 

setWindowTitle(tr( "Text Editor" ) ) ; 

} 

Dans le constructeur, nous creons un QTextEdit et nous le definissons comme widget central. 
Par defaut, QTextEdit accepte des glisser sous forme de texte provenant d'autres applications, 
et si l'utilisateur y depose un fichier, le nom de fichier sera integre dans le texte. Les evene- 
ments drop etant transmis de l'enfant au parent, nous obtenons les evenements drop pour 
toute la fenetre dans MainWindow en desactivant le deposer dans QTextEdit et en l'activant 
dans la fenetre principale. 
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void MainWindow: :dragEnterEvent(QDragEnterEvent *event) 
{ 

if (event->mimeData( )->hasFormat ( " text /uri- list" ) ) 
event->acceptProposedAction ( ) ; 

} 

dragEnterEvent ( ) est appelee des que l'utilisateur fait glisser un objet sur un widget. Si 
nous invoquons acceptProposedAction ( ) sur l'evenement, nous indiquons que l'utilisateur 
est en mesure de deposer cet objet sur ce widget. Par defaut, le widget n'accepterait pas le glisser. 
Qt modifie automatiquement le pointeur pour signaler a l'utilisateur si le widget est en mesure 
d' accepter le depot. 

Dans notre cas, nous voulons que l'utilisateur puisse faire glisser des fichiers, mais rien 
d' autre. Pour ce faire, nous verifions le type MIME du glisser. Le type MIME text/uri-list 
est utilise pour stacker une liste d'URI (universal resource identi?er), qui peuvent etre des 
noms de fichiers, des URL (comme des chemins d'acces HTTP ou FTP) ou d'autres identi- 
fiants globaux de ressource. Les types MIME standards sont dermis par 1TANA (Internet Assi- 
gned Numbers Authority), lis sont constitues d'un type et d'un sous-type separes par un slash. 
Les types MIME sont employes par le presse-papiers et par le systeme du glisser-deposer pour 
identifier les differents types de donnees. La liste officielle des types MIME est disponible a 
l'adresse suivante : http://www.iana.org/assignments/media-types/. 

void MainWindow: :dropEvent(QDropEvent *event) 
{ 

QList<QUrl> urls = event->mimeData()->urls() ; 
if (urls.isEmptyO) 
return; 

QString fileName = urls.f irst ( ) .toLocalFile( ) ; 
if (fileName. isEmpty() ) 
return; 

if (readFile(fileName) ) 

setWindowTitle(tr( "%1 - %2") .arg(fileName) 

.arg(tr("Drag File"))); 

} 

dropEvent ( ) est appelee des que l'utilisateur depose un objet sur un widget. Nous appelons 
QMimeData : : urls ( ) pour obtenir une liste des QUrl. En general, les utilisateurs ne font glis- 
ser qu'un seul fichier a la fois, mais il est possible d'en faire glisser plusieurs en meme temps 
grace a une selection. S'il y a plusieurs URL ou si l'URL ne correspond pas a un nom de 
fichier local, nous retournons immediatement. 

QWidget propose aussi dragMoveEvent ( ) et dragLeaveEvent ( ), mais ces fonctions n'ont 
generalement pas besoin d'etre reimplementees. 

Le deuxieme exemple illustre la facon d'initier un glisser et d' accepter un deposer. 
Nous allons creer une sous-classe QListWidget qui prend en charge le glisser-deposer et 
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nous l'utiliserons en tant que composant de 1' application Project Chooser presentee en 
Figure 9.1. 



Figure 9.1 

L' application 
Project Chooser 



Choose Project 



Project A 



Ciosue Carducci 
Eyvind Johnson 



Sally Prudhomme 



Henryk Sienkiewicz 
Carl Spirteler 
Rabindranath Tagore 
Kawabata Yasunari 



Project B 



Rudolf Eucken 
Anatole France 
Rudyard Kipling 



Thomas Mann 



Eugene O'Neill 
Sigrid Undset 



L' application Project Chooser presente a l'utilisateur deux widgets liste remplis de noms. 
Chaque widget represente un projet. L'utilisateur peut faire glisser et deposer les noms dans les 
widgets liste pour deplacer une personne d'un projet a un autre. 

Le code du glisser-deposer se situe en globalite dans la sous-classe QListWidget. Voici la 
definition de classe : 

class ProjectListWidget : public QListWidget 
{ 

Q_0BJECT 
public: 

ProjectListWidget (QWidget *parent = 0); 
protected: 

void mousePressEvent(QMouseEvent *event); 
void mouseMoveEvent (QMouseEvent *event); 
void dragEnterEvent(QDragEnterEvent *event); 
void dragMoveEvent(QDragMoveEvent *event); 
void dropEvent(QDropEvent *event); 

private: 

void startDrag( ) ; 



QPoint startPos; 

}; 

La classe ProjectListWidget reimplemente cinq gestionnaires d'evenements declares dans 
QWidget. 

ProjectListWidget: : ProjectListWidget (QWidget *parent) 
: QListWidget(parent) 

{ 

setAcceptDrops(true) ; 

} 
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Dans le constructeur, nous activons le deposer sur le widget liste. 

void ProjectListWidget: :mousePressEvent(QMouseEvent *event) 
{ 

if (event->button() == Qt: :LeftButton) 

startPos = event->pos( ) ; 
QListWidget: :mousePressEvent(event) ; 

} 

Quand l'utilisateur appuie sur le bouton gauche de la souris, nous stockons l'emplacement de 
cette derniere dans la variable privee startPos. Nous appelons 1' implementation de mouse- 
PressEvent ( ) du QListWidget pour nous assurer que ce dernier a la possibility de traiter 
des evenements "bouton souris enfonce" comme d'habitude. 

void ProjectListWidget: :mouseMoveEvent(QMouseEvent *event) 
{ 

if (event->buttons() & Qt: :LeftButton) { 

int distance = (event->pos( ) - startPos) .manhattanLength() ; 
if (distance >= QApplication: :startDragDistance()) 
startDragf) ; 

} 

QListWidget: :mouseMoveEvent(event) ; 

} 

Quand l'utilisateur deplace le pointeur tout en maintenant le bouton gauche de la souris 
enfonce, nous commencons un glisser. Nous calculons la distance entre la position actuelle de 
la souris et la position ou le bouton gauche a ete enfonce. Si la distance est superieure a la 
distance recommandee pour demarrer un glisser de QApplication (normalement 4 pixels), 
nous appelons la fonction privee startDrag ( ) pour debuter le glisser. Ceci evite d'initier un 
glisser si la main de l'utilisateur a tremble. 

void ProjectListWidget: :startDrag() 
{ 

QListWidgetltem *item = currentltem( ) ; 
if (item) { 

QMimeData *mimeData = new QMimeData; 

mimeData->setText(item->text( ) ) ; 

QDrag *drag = new QDrag(this); 

drag->setMimeData(mimeData) ; 

drag->setPixmap(QPixmap( " : /images /person. png" ) ) ; 

if (drag->start(Qt: :MoveAction) == Qt : :MoveAction) 
delete item; 

} 

} 

Dans startDrag (), nous creons un objet de type QDrag, this etant son parent. L'objet 
QDrag enregistre les donnees dans un objet QMimeData. Dans notre exemple, nous fournissons 
les donnees sous forme de chaine text/plain au moyen de QMimeData :: setText ( ). 
QMimeData propose plusieurs fonctions permettant de gerer les types les plus courants de glisser 
(images, URL, couleurs, etc.) et peut gerer des types MIME arbitraires represented comme 
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etant des QByteArray. L'appel de QDrag : : setPixmap( ) definit l'icone qui suit le pointeur 
pendant le glisser. 

L'appel de QDrag : : start ( ) debute le glisser et se bloque jusqu'a ce que l'utilisateur depose 
ou annule le glisser. Elle recoit en argument une combinaison des glisser pris en charge 
(Qt : :CopyAction, Qt : :MoveAction et Qt: : LinkAction) et retourne le glisser qui a ete 
execute (ou Qt : : IgnoreAction si aucun glisser n'a ete execute). L' action executee depend de 
ce que le widget source autorise, de ce que la cible supporte et des touches de modification 
enfoncees au moment de deposer. Apres l'appel de start ( ), Qt prend possession de l'objet 
glisse et le supprimera quand il ne sera plus necessaire. 

void ProjectListWidget: :dragEnterEvent(QDragEnterEvent *event) 
{ 

ProjectListWidget *source = 

qobject_cast<ProjectListWidget *>(event->source() ) ; 
if (source && source != this) { 

event->setDropAction(Qt : :MoveAction) ; 

event->accept() ; 

} 

} 

Le widget ProjectListWidget ne sert pas uniquement a initialiser des glisser, il accepte 
aussi des glisser provenant d'un autre ProjectListWidget de la meme application. QDrag- 
EnterEvent: : source () retourne un pointeur vers le widget a l'origine du glisser si ce 
widget fait partie de la meme application ; sinon elle renvoie un pointeur nul. Nous utilisons 
qob j ect_cast<T> ( ) pour nous assurer que le glisser provient d'un Pro j ectListWidget. Si 
tout est correct, nous informons Qt que nous sommes prets a accepter Taction en tant qu' action 
de deplacement. 

void ProjectListWidget: :dragMoveEvent(QDragMoveEvent *event) 
{ 

ProjectListWidget *source = 

qobject_cast<Proj ectListWidget *>(event->source() ) ; 
if (source && source != this) { 

event->setDropAction(Qt : :MoveAction) ; 

event->accept() ; 

} 

} 

Le code dans dragMoveEvent ( ) est identique a ce que nous effectue dans dragEnter- 
Event ( ). II est necessaire parce que nous devons remplacer 1' implementation de la fonction 
dans QListWidget (en fait dans QAbstractltemView). 

void ProjectListWidget: :dropEvent(QDropEvent *event) 
{ 

ProjectListWidget *source = 

qobject_cast<Proj ectListWidget *>(event->source() ) ; 
if (source && source != this) { 

addl tern (e vent ->miineData( )->text( ) ) ; 

event->setDropAction(Qt : :MoveAction) ; 
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event->accept() ; 

} 

} 

Dans dropEvent ( ), nous recuperons le texte glisse a l'aide de QMimeData : : text ( ) et nous 
creons un element avec ce texte. Nous avons egalement besoin d' accepter l'evenement comme 
etant une "action de deplacement" afin de signaler au widget source qu'il peut maintenant 
supprimer la version originale de 1' element glisse. 

Le glisser-deposer est un mecanisme puissant permettant de transferer des donnees entre des 
applications. Cependant, dans certains cas, il est possible d'implementer le glisser-deposer 
sans utiliser les fonctionnalites de glisser-deposer de Qt. Si tout ce que nous souhaitons se 
limite a deplacer des donnees dans un widget d'une application, il suffit de reimplementer 
mousePressEvent ( ) et mouseReleaseEvent ( ). 

Prendre en charge les types personnalises 
de glisser 

Jusqu'a present, nous nous sommes bases sur la prise en charge de QMimeData des types 
MIME communs. Nous avons done appele QMimeData: :setText() pour creer un glisser 
de texte et nous avons execute QMimeData : urls ( ) pour recuperer le contenu d'un glisser 
text/uri-list. Si nous voulons faire glisser du texte brut, du texte HTML, des images, 
des URL ou des couleurs, nous pouvons employer QMimeData sans formalite. Mais si nous 
souhaitons faire glisser des donnees personnalisees, nous devons faire un choix entre 
plusieurs possibilites : 

1. Nous pouvons fournir des donnees arbitraires sous forme de QByteArray en utilisant 
QMimeData: :setData() etles extraire ulterieurement avec QMimeData: :data(). 

2. Nous pouvons deriver QMimeData et reimplementer formats ( ) et retrieveData ( ) pour 
gerer nos types personnalises de donnees. 

3. S'agissant du glisser-deposer dans une seule application, nous avons la possibility de deriver 
QMimeData et de stocker les donnees dans la structure de notre choix. 

La premiere approche n'implique pas de derivation, mais presente certains inconvenients : 
nous devons convertir notre structure de donnees en QByteArray meme si le glisser n'est pas 
accepte a la fin, et si nous voulons proposer plusieurs types MIME pour interagir correctement 
avec une large gamme d' applications, nous devons enregistrer les donnees plusieurs fois (une 
fois pour chaque type MIME). Si les donnees sont nombreuses, 1' application peut etre ralentie 
inutilement. Les deuxieme et troisieme approches permettent d'eviter ou de minimiser ces 
problemes. Ainsi, nous avons un controle total et nous pouvons les utiliser ensemble. 

Pour vous presenter le fonctionnement de ces approches, nous vous montrerons comment ajou- 
ter des fonctions de glisser-deposer a un QTableWidget. Le glisser prendra en charge les types 
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MIME suivants : text /plain, text /html et text/csv. En utilisant la premiere approche, 
voici comment debute un glisser : 

void MyTableWidget: :mouseMoveEvent(QMouseEvent *event) 
{ 

if (event->buttons() & Qt: :LeftButton) { 

int distance = (event->pos( ) - startPos) .manhattanLengthf) ; 
if (distance >= ^Application: :startDragDistance()) 
startDrag( ) ; 

} 

QTableWidget : :mouseMoveEvent(event) ; 

} 

void MyTableWidget: :startDrag() 
{ 

QString plainText = selectionAsPlainText() ; 
if (plainText. isEmpty()) 
return; 

QMimeData *mimeData = new QMimeData; 
mimeData->setText(plainText) ; 
mimeData->setHtml(toHtml(plainText) ) ; 
mimeData->setData( "text/csv" , toCsv(plainText) .toUtf8( ) ) ; 

QDrag *drag = new QDrag(this); 
drag->setMimeData(mimeData) ; 

if (drag->start(Qt: :CopyAction | Qt: :MoveAction) == Qt: :MoveAction) 
deleteSelection() ; 

} 

La fonction privee startDrag ( ) a ete invoquee dans mouseMoveEvent ( ) pour commencer a 
faire glisser une selection rectangulaire. Nous definissons les types MIME text /plain et text/ 
html avec setText( ) et setHtml( ) et nous configurons le type text/csv avec setData( ), 
qui recoit un type MIME arbitraire et un QByteArray. Le code de selectionAsString ( ) est 
plus ou moins le meme que la fonction Spreadsheet : : copy ( ) du Chapitre 4. 

QString MyTableWidget : :toCsv(const QString &plainText) 
{ 

QString result = plainText; 
result. replace! "\\", "WW"); 
result . replace ( " \ " " , " \ \ \ " " ) ; 
result . replace (" \t" , "\", \""); 
result . replace ( " \n" , " \ "\n\ " " ) ; 
result . prependj " \ " " ) ; 
result .append ( " \ " " ) ; 
return result; 

} 

QString MyTableWidget : :toHtml( const QString &plainText) 
{ 

QString result = Qt: :escape(plainText) ; 
result . replace ( " \t " , "<td>" ) ; 



Chapitre 9 



Glisser-deposer 221 



result . replace ( " \n" , " \n<tr><td>" ) ; 
result .prependj "<table>\n<tr><td>" ) ; 
result. append("\n</table>") ; 
return result; 

} 

Les fonctions toCsv ( ) et toHtml ( ) convertissent une chaine "tabulations et sauts de ligne" 
en une chaine CSV (comma-separated values, valeurs separees par des virgules) ou HTML. 
Par exemple, les donnees 

Red Green Blue 
Cyan Yellow Magenta 

sont converties en 

"Red", "Green", "Blue" 
"Cyan", "Yellow", "Magenta" 

ou en 

<table> 

<tr><td>Red<td>Green<td>Blue 

<tr><td>Cyan<td>Yellow<td>Magenta 

</table> 

La conversion est effectuee de la maniere la plus simple possible, en executant 
QString :: replace ( ). Pour eviter les caracteres speciaux HTML, nous employons 
Qt: :escape(). 

void MyTableWidget: :dropEvent(QDropEvent *event) 
{ 

if (event->mimeData()->hasFormat("text/csv")) { 

QByteArray csvData = event->mimeData()->data("text/csv") ; 
QString csvText = QString: :f romlltf8(csvData) ; 

event->acceptProposedAction ( ) ; 
} else if (event->mimeData( )->hasFormat( "text/plain" ) ) { 
QString plainText = event->mimeData()->text() ; 

event->acceptProposedAction( ) ; 

} 

} 

Meme si nous fournissons les donnees dans trois formats differents, nous n'acceptons que deux 
d'entre eux dans dropEvent ( ). Si l'utilisateur fait glisser des cellules depuis un QTableWid- 
get vers un editeur HTML, nous voulons que les cellules soient converties en un tableau 
HTML. Mais si l'utilisateur fait glisser un code HTML arbitraire vers un QTableWidget, nous 
ne voulons pas 1' accepter. 

Pour que cet exemple fonctionne, nous devons egalement appeler setAcceptDrops (true) et 
setSelectionMode(ContiguousSelection) dans le constructeur de MyTableWidget. 
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Nous allons refaire notre exemple, mais cette fois-ci nous deriverons QMimeData pour ajourner 
ou eviter les conversions (potentiellement onereuses en termes de performances) entre 
QTableWidgetltem et QByteArray. Voici la definition de notre sous-classe : 

class TableMimeData : public QMimeData 
{ 

Q_0BJECT 
public: 

TableMimeData (const QTableWidget *tableWidget , 

const QTableWidgetSelectionRange &range); 

const QTableWidget *tableWidget( ) const { return myTableWidget; } 
QTableWidgetSelectionRange rangef) const { return myRange; } 
QStringList formats () const; 

protected: 

QVariant retrieveDatafconst QString &format, 

QVariant: :Type preferredType) const; 

private: 

static QString toHtmlfconst QString &plainText); 
static QString toCsv(const QString &plainText); 

QString text(int row, int column) const; 
QString rangeAsPlainText( ) const; 

const QTableWidget *myTableWidget; 
QTableWidgetSelectionRange myRange; 
QStringList myFormats; 

}; 

Au lieu de stacker les donnees reelles, nous enregistrons un QTableWidgetSelectionRange 
qui specifie quelles cellules ont ete glissees et nous conservons un pointeur vers QTableWid- 
get. Les fonctions formats ( ) et retrieveData ( ) sont reimplementees dans QMimeData. 

TableMimeData: :TableMimeData(const QTableWidget *tableWidget, 

const QTableWidgetSelectionRange &range) 

{ 

myTableWidget = tableWidget; 
myRange = range; 

myFormats « "text/csv" « "text/html" « "text/plain"; 

} 

Dans le constructeur, nous initialisons les variables privees. 

QStringList TableMimeData: :formats( ) const 
{ 

return myFormats; 

} 
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La fonction formats ( ) retourne une liste de types MIME fournie par l'objet MIME. Lordre 
precis des formats n'est generalement pas important, mais il est recommande de placer les 
"meilleurs" formats en premier. II arrive en effet que les applications qui prennent en charge de 
nombreux formats choisissent le premier qui convient. 

QVariant TableMimeData: : retrieveData(const QString &format, 

QVariant: :Type pref erredType) const 

{ 

if (format == "text/plain") { 

return rangeAsPlainText() ; 
} else if (format == "text/csv") { 

return toCsvfrangeAsPlainText ( ) ) ; 
} else if (format == "text/html") { 

return toHtml(rangeAsPlainText()) ; 
} else { 

return QMimeData: : retrieveData(format, preferredType) ; 

} 

} 

La fonction retrieveData( ) retourne les donnees d'un type MIME particulier sous forme de 
QVariant. La valeur du parametre de format correspond normalement a une des chaines 
retournees par formats ( ), mais nous ne pouvons pas en attester, etant donne que toutes les 
applications ne comparent pas le type MIME a formats(). Les fonctions d'acces text(), 
html(), urls(), imageData(), colorData() et data() proposees par QMimeData sont 
implementees en termes de retrieveData( ). 

Le parametre preferredType est un bon indicateur du type que nous devrions placer dans 
QVariant. Ici, nous l'ignorons et nous faisons confiance a QMimeData pour convertir la valeur 
de retour dans le type souhaite, si necessaire. 

void MyTableWidget: :dropEvent(QDropEvent *event) 
{ 

const TableMimeData *tableData = 

qobject_cast<const TableMimeData *>(event->mimeData() ) ; 

if (tableData) { 

const QTableWidget *otherTable = tableData->tableWidget() ; 
QTableWidgetSelectionRange otherRange = tableData->range( ) ; 

event->acceptProposedAction ( ) ; 
} else if (event->mimeData( )->hasFormat( "text/csv" ) ) { 

QByteArray csvData = event->mimeData()->data("text/csv") ; 
QString csvText = QString: :f romUtf8(csvData) ; 

event->acceptProposedAction ( ) ; 
} else if (event->mimeData( )->hasFormat( "text/plain" ) ) { 
QString plainText = event->mimeData()->text() ; 

event->acceptProposedAction( ) ; 

} 

QTableWidget: :mouseMoveEvent(event) ; 

} 
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La fonction dropEvent ( ) ressemble a celle presentee precedemment dans cette section, mais 
cette fois-ci nous l'optimisons en verifiant d'abord si nous pouvons convertir en toute securite 
l'objet QMimeData en TableMimeData. Si qobject_cast<T>( ) fonctionne, cela signirie 
qu'un MyTableWidget de la meme application etait a rorigine du glisser, et nous pouvons 
directement acceder aux donnees de la table au lieu de passer par l'API de QMimeData. Si la 
conversion echoue, nous extrayons les donnees de facon habituelle. 

Dans cet exemple, nous avons code le texte CSV avec le format de codage UTF-8. Si nous 
voulions etre stirs d'utiliser le bon codage, nous aurions pu utiliser le parametre charset du 
type MIME text / plain de sorte a specifier un codage explicite. Voici quelques exemples : 

text /plain ;charset=US-ASCI I 
text /plain ;charset=IS0-8859-1 
text / plain ; charset=Shift_J IS 
text /plain ;charset=UTF-8 

Gerer le presse-papiers 

La plupart des applications emploient la gestion integree du presse-papiers de Qt d'une 
maniere ou d'une autre. Par exemple, la classe QTextEdit propose les slots cut ( ), copy ( ) et 
paste ( ), de meme que des raccourcis clavier. Vous n'avez done pas besoin de code supple- 
mentaire, ou alors tres peu. 

Quand vous ecrivez vos propres classes, vous pouvez acceder au presse-papiers par le biais de 
QApplication : : clipboard ( ), qui retourne un pointeur vers l'objet QClipboard de l'appli- 
cation. Gerer le presse-papiers s'avere assez facile : vous appelez setText ( ), set Image ( ) ou 
setPixmap() pour placer des donnees dans le presse-papiers, puis vous appelez text(), 
image ( ) ou pixmap( ) pour y recuperer les donnees. Nous avons deja analyse des exemples 
d' utilisation du presse-papiers dans 1' application Spreadsheet du Chapitre 4. 

Pour certaines applications, la fonctionnalite integree peut etre insuffisante. Par exemple, nous 
voulons pouvoir fournir des donnees qui ne soient pas uniquement du texte ou une image, ou 
proposer des donnees en differents formats pour un maximum d'interoperabilite avec d'autres 
applications. Ce probleme ressemble beaucoup a ce que nous avons rencontre precedemment 
avec le glisser-deposer et la reponse est similaire : nous pouvons deriver QMimeData et reim- 
plementer quelques fonctions virtuelles. 

Si notre application prend en charge le glisser-deposer via une sous-classe QMimeData person- 
nalisee, nous pouvons simplement reutiliser cette sous-classe et la placer dans le presse-papiers 
en employant la fonction setMimeData( ). Pour recuperer les donnees, nous avons la possi- 
bility d'invoquer mimeData( ) sur le presse-papiers. 

Sous XI 1, il est habituellement possible de coller une selection en cliquant sur le bouton du 
milieu d'une souris dotee de trois boutons. Vous faites alors appel a un presse-papiers de 
"selection" distinct. Si vous souhaitez que vos widgets supportent ce genre de presse-papiers 
en complement du presse-papiers standard, vous devez transmettre QClipboard : : Selection 
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comme argument supplemental aux divers appels du presse-papiers. Voici par exemple comment 
nous reimplementerions mouseReleaseEvent() dans un editeur de texte pour prendre en 
charge le collage avec le bouton du milieu de la souris : 

void MyTextEditor: :mouseReleaseEvent(QMouseEvent *event) 
{ 

QClipboard Clipboard = QApplication: :clipboard( ) ; 
if (event->button() == Qt : :MidButton 

&& clipboard->supportsSelection()) { 

QString text = clipboard->text(QClipboard: :Selection) ; 

pasteText(text) ; 

} 

} 

Sous Xll, la fonction supportsSelection ( ) retourne true. Sur les autres plates-formes, 
elle renvoie false. 

Si vous voulez etre informe des que le contenu du presse-papiers change, vous pouvez connecter 
le signal QClipboard : : dataChanged ( ) a un slot personnalise. 
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Au sommaire de ce chapitre 

^ Utiliser les classes dediees a l'affi- 
chage d' elements 

Utiliser des modeles predefinis 

^ Implementer des modeles person- 
nalises 

^ Implementer des delegues person- 
nalises 



Beaucoup d' applications ont pour objectif la recherche, l'affichage et la modification 
d'elements individuels appartenant a un ensemble de donnees. Ces donnees peuvent se 
trouver dans des nchiers, des bases de donnees ou des serveurs de reseau. L'approche 
standard relative au traitement des ensembles de donnees consiste a utiliser les classes 
d'affichage d'elements de Qt. 

Dans les versions anterieures de Qt, les widgets d'affichage d'elements etaient alimen- 
tes avec la totalite de l'ensemble de donnees ; les utilisateurs pouvaient effectuer toutes 
leurs recherches et modifications sur les donnees hebergees dans le widget, et a un 
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moment donne, les modifications etaient sauvegardees dans la source de donnees. Meme si elle 
est simple a comprendre et a utiliser, cette approche n'est pas adaptee aux tres grands ensem- 
bles de donnees, ni pour l'affichage du meme ensemble de donnees dans deux ou plusieurs 
widgets differents. 

Le langage Smalltalk a fait connaitre une methode flexible permettant de visualiser de grands 
ensembles de donnees : MVC (Modele -Vue -Controleur). Dans 1' approche MVC, le modele 
represente 1' ensemble de donnees et il se charge de recuperer les donnees necessaires pour affi- 
cher et enregistrer toute modification. Chaque type d'ensemble de donnees possede son propre 
modele, mais 1' API que les modeles proposent aux vues est identique quel que soit l'ensemble 
de donnees sous-jacent. La vue presente les donnees a l'utilisateur. Seule une quantite limitee 
de donnees d'un grand ensemble sera visible en meme temps, c'est-a-dire celles demandees 
par la vue. Le contrdleur sert d' intermediate entre l'utilisateur et la vue ; il convertit les 
actions utilisateur en requetes pour rechercher ou modifier des donnees, que la vue transmet 
ensuite au modele si necessaire. 



Qt propose une architecture modele/vue inspiree de l'approche MVC (voir Figure 10.1). 
Dans Qt, le modele se comporte de la meme maniere que pour le MVC classique. Mais a la 
place du controleur, Qt utilise une notion legerement differente : le delegue. Le delegue offre 
un controle precis de la maniere dont les elements sont affiches et modifies. Qt fournit un dele- 
gue par defaut pour chaque type de vue. C'est suffisant pour la plupart des applications, c'est 
pourquoi nous n'avons generalement pas besoin de nous en preoccuper. 

Grace a 1' architecture modele/vue de Qt, nous avons la possibility d'utiliser des modeles qui ne 
recuperent que les donnees necessaires a l'affichage de la vue. Nous gerons done de tres grands 
ensembles de donnees beaucoup plus rapidement et nous consommons moins de memoire que 
si nous devions lire toutes les donnees. De plus, en enregistrant un modele avec deux vues ou 
plus, nous donnons l'opportunite a l'utilisateur d'afficher et d'interagir avec les donnees de 
differentes manieres, avec peu de surcharge (voir Figure 10.2). Qt synchronise automatique- 
ment plusieurs vues, refletant les changements apportes dans l'une d'elles dans toutes les 
autres. L' architecture modele/vue presente un autre avantage : si nous decidons de modifier 
la facon dont l'ensemble de donnees sous-jacent est enregistre, nous n'avons qu'a changer le 
modele ; les vues continueront a se comporter correctement. 

En general, nous ne devons presenter qu'un nombre relativement faible d' elements a 
l'utilisateur. Dans ces cas frequents, nous pouvons utiliser les classes d'affichage d' elements 
de Qt (QListWidget, QTableWidget et QTreeWidget) specialement concues a cet effet et 
directement y enregistrer des elements. Ces classes se comportent de maniere similaire aux 
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classes d'affichage d'elements proposees par les versions anterieures de Qt. Elles stockent 
leurs donnees dans des "elements" (par exemple, un QTableWidget contient des QTableWid- 
getltem). En interne, ces classes s'appuient sur des modeles personnalises qui africhent les 
elements destines aux vues. 
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Figure 10.2 

Un modele pent desservir plusieurs vues 

S'agissant des grands ensembles de donnees, la duplication des donnees est souvent peu 
recommandee. Dans ces cas, nous pouvons utiliser les vues de Qt (QListView, QTableView, 
et QTreeView, ), en association avec un modele de donnees, qui peut etre un modele person- 
nalise ou un des modeles predefinis de Qt. Par exemple, si l'ensemble de donnees se 
trouve dans une base de donnees, nous pouvons combiner un QTableView avec un QSql- 
TableModel. 

Utiliser les classes dediees a I'affichage 
d'elements 

Utiliser les sous-classes d'affichage d'elements de Qt est generalement plus simple que de 
definir un modele personnalise, et cette solution est plus appropriee quand la separation du 
modele et de la vue ne presente aucun interet particulier. Nous avons employe cette technique 
dans le Chapitre 4 quand nous avons derive QTableWidget et QTableWidgetltem pour 
implementer la fonctionnalite de feuille de calcul. 

Dans cette section, nous verrons comment utiliser les sous-classes d'affichage d'elements pour 
afhcher des elements. Le premier exemple vous presente un QListWidget en lecture seule, le 
deuxieme exemple vous montre un QTableWidget modifiable et le troisieme vous expose un 
QTreeWidget en lecture seule. 

Nous commengons par une boite de dialogue simple qui propose a l'utilisateur de choisir un 
symbole d'organigramme dans une liste, comme illustre en Figure 10.3. Chaque element est 
compose d'une icone, de texte et d'un ID unique. 
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L' application 
Flowchart Symbol Picker 
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Analysons d'abord un extrait du fichier d'en-tete de la boite de dialogue 

class FlowChartSymbolPicker : public QDialog 
{ 

Q_0BJECT 
public: 

FlowChartSymbolPickerfconst QMap<int, QString> &symbolMap, 
QWidget *parent = 0) ; 

int selectedld( ) const { return id; } 
void donefint result) ; 



}; 

Quand nous construisons la boite de dialogue, nous devons lui transmettre un 
QMap<int , QString> et apres son execution, nous pouvons recuperer l'ID choisi (ou -1 si 
l'utilisateur n'a choisi aucun element) en appelant selectedld ( ). 

FlowChartSymbolPicker: : FlowChartSymbolPicker ( 

const QMap<int, QString> &symbolMap, QWidget *parent) 
: QDialog(parent) 



{ 



id = -1; 

listWidget = new QListWidget; 
listWidget->setIconSize(QSize(60, 60) ) ; 

QMapIterator<int, QString> i(symbolMap) ; 

while (i.hasNext()) { 
i.nextf ) ; 

QListWidgetltem *item = new QListWidgetItem(i. valuef ) , 

listWidget) ; 

item->set Icon (iconForSymbol(i. value ( ) ) ) ; 
item->setData(Qt : :UserRole, i. key ( ) ) ; 

} 
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Nous initialisons id (le dernier ID selectionne) a -1. Puis nous construisons un QListWidget, 
un widget dedie a 1'affichage d'elements. Nous parcourons chaque element dans la liste des 
symboles d'organi gramme et nous creons un QListWidget Item pour representer chacun 
d'eux. Le constructeur de QListWidgetltem recoit un QString qui represente le texte a afficher, 
suivi par le parent QListWidget. 

Nous definissons ensuite l'icone de l'element et nous invoquons setData( ) pour enregistrer 
notre ID arbitraire dans le QListWidgetltem. La fonction privee iconForSymbol ( ) retourne 
un Qlcon pour un nom de symbole donne. 

Les QListWidgetltem endossent plusieurs roles, chacun ayant un QVariant associe. Les 
roles les plus courants sont Qt : : DisplayRole, Qt::EditRole et Qt : : IconRole, pour 
lesquels il existe des fonctions dediees d'acces et de reglage (setText ( ), set I con ( )). Toute- 
fois, il existe plusieurs autres roles. Nous pouvons aussi definir des roles personnalises en 
specifiant une valeur numerique de Qt : :UserRole ou plus haut. Dans notre exemple, nous 
utilisons Qt: :UserRole pour stacker FID de chaque element. 

La partie non representee du constructeur se charge de creer les boutons, de disposer les 
widgets et de definir le titre de la fenetre. 

void FlowChartSymbolPicker: :done(int result) 
{ 

id = -1; 

if (result == QDialog: : Accepted) { 

QListWidgetltem *item = listWidget->currentItem( ) ; 
if (item) 

id = item->data(Qt: :UserRole) .toInt() ; 

} 

QDialog: :done(result) ; 

} 

La fonction done() est reimplementee dans QDialog. Elle est appelee quand l'utilisateur 
appuie sur OK ou Cancel. Si l'utilisateur a clique sur OK, nous recuperons l'element pertinent 
et nous extrayons l'ID grace a la fonction data( ). Si nous etions interesses par le texte de 
l'element, nous aurions pu le recuperer en invoquant item->data(Qt :: Display- 
Role) . toString ( ) ou, ce qui est plus pratique, item->text ( ). 

Par defaut, QListWidget est en lecture seule. Si nous voulions que l'utilisateur puisse modi- 
fier les elements, nous aurions pu definir les declencheurs de modification de la vue au moyen 
de QAbstractltemView: : setEditTriggers ( ) ; par exemple, configurer QAbstract- 
ItemView: : AnyKeyPressed signifie que l'utilisateur peut modifier un element simplement 
en commencant a taper quelque chose. Nous aurions aussi pu proposer un bouton Edit (ou 
peut-etre des boutons Add et Delete) et les connecter aux slots, de sorte d'etre en mesure de 
gerer les operations de modification par programme. 

Maintenant que nous avons vu comment utiliser une classe dediee a 1'affichage d'elements 
pour afficher et selectionner des donnees, nous allons etudier un exemple oil nous pouvons 
modifier des donnees. Nous utilisons a nouveau une boite de dialogue, mais cette fois-ci, elle 
presente un ensemble de coordonnees (x, y) que l'utilisateur peut modifier (voir Figure 10.4). 
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Figure 10.4 
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Comme pour l'exemple precedent, nous nous concentrerons sur le code d'affichage de 
1' element, en commencant par le constructeur. 

CoordinateSetter: :CoordinateSetter(QList<QPointF> *coords, 

QWidget *parent) 

: QDialog(parent) 

{ 

coordinates = coords; 

tableWidget = new QTableWidget(0, 2); 
tableWidget->setHorizontalHeaderLabels( 

QStringList() « tr("X") « tr("Y")); 

for (int row = 0; row < coordinates->count() ; ++row) { 
QPointF point = coordinates->at(row) ; 
addRow( ) ; 

tableWidget->item(row, 0)->setText (QString: : number (point .x( ) ) ) ; 
tableWidget->item(row, 1 )->setText (QString: : number (point .y( ) ) ) ; 

} 

} 

Le constructeur de QTableWidget recoit le nombre initial de lignes et de colonnes du tableau 
a afficher. Chaque element dans un QTableWidget est represents par un QTableWidget Item, 
y compris les en-tetes horizontaux et verticaux. La fonction setHorizontalHeader- 
Labels ( ) inscrit dans chaque element horizontal du widget tableau le texte qui lui est fourni 
sous forme d'une liste de chaines en argument. Par defaut, QTableWidget propose un en-tete 
vertical avec des lignes intitulees a partir de 1, ce qui correspond exactement a ce que nous 
recherchons, nous ne sommes done pas contraints de configurer manuellement les intitules de 
P en-tete vertical. 

Une fois que nous avons cree et centre les intitules des colonnes, nous parcourons les coordon- 
nees transmises. Pour chaque paire (x, y), nous creons deux QTableWidget Item correspondant 
aux coordonnees x ety. Les elements sont ajoutes au tableau grace a QTableWidget : : set- 
Item ( ) , qui recoit une ligne et une colonne en plus de 1' element. 
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Par defaut, QTableWidget autorise les modifications. L'utilisateur peut modifier route cellule 
du tableau en la recherchant puis en appuyant sur F2 ou simplement en saisissant quelque 
chose. Tous les changements effectues par l'utilisateur dans la vue se refleteront automatique- 
ment dans les QTableWidget Item. Pour eviter les modifications, nous avons la possibilite 
d'appeler setEditTriggers (QAbstractltemView: : NoEditTriggers). 

void CoordinateSetter: :addRow( ) 
{ 

int row = tableWidget->rowCount( ) ; 

tableWidget->insertRow(row) ; 

QTableWidgetltem *item0 = new QTableWidgetltem; 
item0->setTextAlignment(Qt: :AlignRight | Qt: :AlignVCenter) ; 
tableWidget->setItem(row, 0, itemO); 

QTableWidgetltem *item1 = new QTableWidgetltem; 
item1->setTextAlignment(Qt: :AlignRight | Qt: :AlignVCenter) ; 
tableWidget->setItem(row, 1, iteml); 

tableWidget->setCurrentItem(item0) ; 

} 

Le slot addRow( ) est appele lorsque l'utilisateur clique sur le bouton Add Row. Nous ajoutons 
une nouvelle ligne a l'aide de insertRow(). Si l'utilisateur essaie de modifier une cellule 
dans la nouvelle ligne, QTableWidget creera automatiquement un nouveau QTableWidget- 
ltem. 

void CoordinateSetter: :done(int result) 
{ 

if (result == QDialog: : Accepted) { 
coordinates->clear( ) ; 

for (int row = 0; row < tableWidget->rowCount( ) ; ++row) { 
double x = tableWidget->item(row, 0)->text() .toDouble() ; 
double y = tableWidget->item(row, 1 )->text() .toDouble() ; 
coordinates->append(QPointF(x, y) ) ; 

} 

} 

QDialog: :done(result) ; 

} 

Enfin, quand l'utilisateur clique sur OK, nous effacons les coordonnees qui avaient ete trans- 
mises a la boite de dialogue et nous creons un nouvel ensemble base sur les coordonnees des 
elements du QTableWidget. 

Pour notre troisieme et dernier exemple de widget dedie a l'affichage d'elements de Qt, nous 
allons analyser quelques extraits de code d'une application qui affiche les parametres d'une 
application Qt grace a un QTreeWidget (voir Figure 10.5). La lecture seule est l'option par 
defaut de QTreeWidget . 
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Figure 10.5 

L' application 
Settings Viewer 
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Voici un extrait du constracteur : 

SettingsViewer : :SettingsViewer(QWidget 
: QDialog(parent) 



'parent) 



{ 



organization 
application = 



"Trolltech" 
"Designer" ; 



treeWidget = new QTreeWidget; 
treeWidget->setColumnCount(2) ; 
treeWidget->setHeaderLabels ( 

QStringList() « trf'Key 
treeWidget->header 
treeWidget->header 



« tr("Value")); 
->setResizeMode(0, QHeaderView: :Stretch) 
->setResizeMode(1 , QHeaderView: :Stretch) 



setWindowTitle(tr( "Settings Viewer" ] 
readSettings( ) ; 



} 



Pour acceder aux parametres d'une application, un objet QSettings doit etre cree avec le nom 
de 1' organisation et le nom de 1' application comme parametres. Nous definissons des noms par 
defaut ("Designer" par "Trolltech"), puis nous construisons un nouveau QTreeWidget. Pour 
terminer, nous appelons la fonction readSettings(). 

void SettingsViewer: : readSettingsf ) 
{ 

QSettings settings(organization, application); 

treeWidget->clear( ) ; 
addChildSettings(settings, 0, ""); 

treeWidget->sortByColumn(0) ; 
treeWidget->setFocus() ; 

setWindowTitle(tr( "Settings Viewer - %1 by %2") 

.arg(application) .arg(organization) ) ; 
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Les parametres d' application sont stockes dans une hierarchie de cles et de valeurs. La fonc- 
tion privee addChildSettings ( ) recoit un objet settings, un parent QTreeWidgetltem et 
le "groupe" en cours. Un groupe est l'equivalent QSettings d'un repertoire de systeme de 
fichiers. La fonction addChildSettings ( ) peut s'appeler elle-meme de maniere recursive 
pour faire defiler une arborescence arbitraire. Le premier appel de la fonction readSet- 
tings ( ) transmet 0 comme element parent pour representer la racine. 

void SettingsViewer: : addChildSettings (QSettings &settings, 
QTreeWidgetltem *parent, const QString &group) 

{ 

QTreeWidgetltem *item; 

settings. beginGroup(group) ; 

foreach (QString key, settings. childKeys() ) { 
if (parent) { 

item = new QTreeWidgetltem(parent) ; 
} else { 

item = new QTreeWidgetltem(treeWidget) ; 

} 

item->setText(0, key); 

item->setText (1 , settings. value (key) .toString( ) ) ; 

} 

foreach (QString group, settings. childGroups()) { 
if (parent) { 

item = new QTreeWidgetltem(parent) ; 
} else { 

item = new QTreeWidgetltem(treeWidget) ; 

} 

item->setText(0, group); 
addChildSettings(settings, item, group); 

} 

settings. endGroup() ; 

} 

La fonction addChildSettings ( ) est utilisee pour creer tous les QTreeWidgetltem. Elle 
parcourt toutes les cles au niveau en cours dans la hierarchie des parametres et cree un 
QTableWidgetltem par cle. Si 0 est transmis en tant qu'element parent, nous creons 
l'element comme etant un enfant de QTreeWidget (il devient done un element de haut 
niveau) ; sinon, nous creons l'element comme etant un enfant de parent. La premiere colonne 
correspond au nom de la cle et la seconde a la valeur correspondante. 

La fonction parcourt ensuite chaque groupe du niveau en cours. Pour chacun d'eux, un 
nouveau QTreeWidgetltem est cree avec sa premiere colonne definie en nom du groupe. Puis, 
la fonction s'appelle elle-meme de maniere recursive avec l'element de groupe comme parent 
pour alimenter le QTreeWidget avec les elements enfants du groupe. 

Les widgets d'affichage d'elements presentes dans cette section nous permettent d'utiliser un 
style de programmation tres similaire a celui utilise dans les versions anterieures de Qt : lire 
tout un ensemble de donnees dans un widget d'affichage d'elements, utiliser les objets des 
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elements pour representer les elements de donnees, et (si les elements sont modifiables) sauve- 
garder sur la source de donnees. Dans les sections suivantes, nous irons plus loin que cette 
approche simple et nous profiterons pleinement de 1' architecture modele/vue de Qt. 

Utiliser des modeles predefinis 

Qt propose plusieurs modeles predefinis a utiliser avec les classes d'affichage : 



QStringListModel 


Stocke une liste de chaines 


QStandardltemModel 


Stocke des donnees hierarchiques arbitraires 


QDirModel 


Encapsule le systeme de richiers local 


QSqlQueryModel 


Encapsule un jeu de resultats SQL 


QSqlTableModel 


Encapsule une table SQL 


QSqlRelationalTableModel 


Encapsule une table SQL avec des cles etrangeres 


QSortFilterProxyModel 


Trie et/ou filtre un autre modele 



Dans cette section, nous verrons comment employer QStringListModel, QDirModel et 
QSortFilterProxyModel. Les modeles SQL sont traites au Chapitre 13. 

Commencons par une boite de dialogue simple dont les utilisateurs peuvent se servir pour 
ajouter, supprimer et modifier un QSt ring List, oil chaque chaine represente un chef d'equipe. 
Celle-ci est presentee en Figure 10.6. 



Figure 10.6 

L' application 
Team Leaders 



Team Leaders 
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Voici un extrait pertinent du constructeur : 



TeamLeadersDialog: :TeamLeadersDialog(const QStringList &leaders, 

QWidget *parent) 
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: QDialog(parent) 

{ 

model = new QStringListModel(this) ; 
model->setStringList(leaders) ; 

listView = new QListView; 
listView->setModel(model) ; 

listView->setEditTriggers(QAbstractItemView: :AnyKeyPressed 

| QAbstractltemView: :DoubleClicked) ; 

} 

Nous creons et alimentons d'abord un QStringListModel. Nous creons ensuite un QList- 
View et nous lui affectons comme modele un de ceux que nous venons de creer. Nous configu- 
rons egalement des declencheurs de modification pour permettre a l'utilisateur de modifier une 
chaine simplement en commencant a taper quelque chose ou en double-cliquant dessus. Par 
defaut, aucun declencheur de modification n'est defini sur un QListView, la vue est done 
configuree en lecture seule. 

void TeamLeadersDialog: : insert () 
{ 

int row = listView->currentIndex( ) . row( ) ; 
model->insertRows(row, 1); 

QModellndex index = model->index(row) ; 
listView- >setCur rent I ndex( index) ; 
listView->edit( index) ; 

} 

Le slot insert () est invoque lorsque l'utilisateur clique sur le bouton Insert. Le slot 
commence par recuperer le numero de ligne de 1' element en cours dans la vue de liste. Chaque 
element de donnees dans un modele possede un "index de modele" correspondant qui est 
represents par un objet QModellndex. Nous allons etudier les index de modele plus en detail 
dans la prochaine section, mais pour l'instant il suffit de savoir qu'un index comporte trois 
composants principaux : une ligne, une colonne et un pointeur vers le modele auquel il appartient. 
Pour un modele liste unidimensionnel, la colonne est toujours 0. 

Lorsque nous connaissons le numero de ligne, nous inserons une nouvelle ligne a cet endroit. 
L' insertion est effectuee sur le modele et le modele met automatiquement a jour la vue de liste. 
Nous definissons ensuite l'index en cours de la vue de liste sur la ligne vide que nous venons 
d'inserer. Enfin, nous definissons la vue de liste en mode de modification sur la nouvelle ligne, 
comme si l'utilisateur avait appuye sur une touche ou double-clique pour initier la modification. 

void TeamLeadersDialog: :del() 
{ 

model->removeRows(listView->currentIndex() . row() , 1 ) ; 

} 

Dans le constructeur, le signal clicked ( ) du bouton Delete est relie au slot del( ). Vu que 
nous avons supprime la ligne en cours, nous pouvons appeler removeRows ( ) avec la position 
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actuelle d' index et un nombre de lignes de 1. Comme avec 1' insertion, nous nous basons sur le 
modele pour mettre a jour la vue de facon appropriee. 

QStringList TeamLeadersDialog: : leaders () const 
{ 

return model->stringList( ) ; 

} 

Enfin, la fonction leaders ( ) procure un moyen de lire les chaines modifiees quand la boite de 
dialogue est fermee. 

TeamLeadersDialog pourrait devenir une boite de dialogue generique de modification de 
liste de chaines simplement en parametrant le titre de sa fenetre. Une autre boite de dialogue 
generique souvent demandee est une boite qui presente une liste de fichiers ou de repertoires a 
l'utilisateur. Le prochain exemple exploite la classe QDirModel, qui encapsule le systeme de 
fichiers de 1' ordinate ur et qui peut afficher (et masquer) les divers attributs de fichiers. Ce 
modele peut appliquer un nitre pour limiter les types d' entrees du systeme de fichiers qui sont 
affichees et peut organiser les entrees de plusieurs manieres differentes. 



Figure 10.7 

L' application 
Directory Viewer 



Directory Viewer 
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Nous analyserons d'abord la creation et nous configurerons le modele et la vue dans le constructeur 
de la boite de dialogue Directory Viewer (voir Figure 10.7). 

DirectoryViewer: :DirectoryViewer(QWidget *parent) 
: QDialog(parent) 

{ 

model = new QDirModel; 
model->setReadOnly(false) ; 

model->setSorting(QDir: :DirsFirst | QDir: : IgnoreCase | QDir: :Name) ; 

treeView = new QTreeView; 
treeView->setModel(model) ; 

treeView->header( )->setStretchLastSection(true) ; 
treeView->neader()->setSortIndicator(0, Qt: :AscendingOrder) ; 
treeView->header( )->setSortIndicatorShown(true) ; 
treeView->header( )->setClickable(true) ; 
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QModellndex index = model->index(QDir: :currentPath()) ; 
treeView->expand(index) ; 
treeView->scrollTo(index) ; 
treeView->resizeColumnToContents(0) ; 

} 

Lorsque le modele a ete construit, nous faisons le necessaire pour qu'il puisse etre modifie et 
nous definissons les divers attributs d'ordre de tri. Nous creons ensuite le QTreeViewqui affi- 
chera les donnees du modele. L'en-tete du QTreeView peut etre utilise pour proposer un tri 
controle par l'utilisateur. Si cet en-tete est cliquable, l'utilisateur est en mesure de trier 
n'importe quelle colonne en cliquant sur ce dernier ; en cliquant plusieurs fois dessus, il choisit 
entre les tris croissants et decroissants. Une fois que l'en-tete de l'arborescence a ete configure, 
nous obtenons 1' index de modele du repertoire en cours et nous sommes stirs que ce repertoire 
est visible en developpant ses parents si necessaire a l'aide de expand ( ) et en le localisant 
grace a sc rollTo ( ) . Nous nous assurons egalement que la premiere colonne est suffisamment 
grande pour afficher toutes les entrees sans utiliser de points de suspension (...). 

Dans la partie du code du constructeur qui n'est pas presentee ici, nous avons connecte les 
boutons Create Directory (Creer un repertoire) et Remove (Supprimer) aux slots pour effectuer 
ces actions. Nous n' avons pas besoin de bouton Rename parce que les utilisateurs peuvent 
renommer directement en appuyant sur F2 et en tapant du texte. 

void DirectoryViewer: :createDirectory() 
{ 

QModellndex index = treeView->currentIndex( ) ; 
if (! index. isValid()) 
return; 

QString dirName = QlnputDialog: :getText(this, 

tr( "Create Directory"), 
tr( "Directory name" ) ) ; 

if ( IdirName. isEmpty ( ) ) { 

if ( !model->mkdir( index, dirName) .isValid()) 

QMessageBox: : informationfthis, tr("Create Directory"), 
tr( "Failed to create the directory")); 

} 

} 

Si l'utilisateur entre un nom de repertoire dans la boite de dialogue, nous essayons de creer un 
repertoire avec ce nom comme enfant du repertoire en cours. La fonction QDirModel : : mkdir ( ) 
recoit 1' index du repertoire parent et le nom du nouveau repertoire, et retourne 1' index de 
modele du repertoire qu'il a cree. Si l'operation echoue, elle retourne un index de modele 
invalide. 

void DirectoryViewer: : remove () 
{ 

QModellndex index = treeView->current!ndex( ) ; 
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} 



if (! index. isValid()) 
return; 

bool ok; 

if (model->f ilelnfo(index) .isDirf 
ok = model->rmdir(index) ; 

} else { 

ok = model->remove (index) ; 

} 

if (!ok) 

QMessageBox : : information (this , 
tr( "Failed to remove ■ 



tr( "Remove" ) , 

.1 " ) .arg(model->fileName(index) 



Si l'utilisateur clique sur Remove, nous tentons de supprimer le fichier ou le repertoire associe 
a l'element en cours. Pour ce faire, nous pourrions utiliser QDir, mais QDirModel propose des 
fonctions pratiques qui fonctionnent avec QModellndexes. 

Le dernier exemple de cette section vous montre comment employer QSortFilterProxy- 
Model. Contrairement aux autres modeles predefinis, ce modele encapsule un modele existant 
et manipule les donnees qui sont transmises entre le modele sous-jacent et la vue. Dans notre 
exemple, le modele sous-jacent est un QStringListModel initialise avec la liste des noms de 
couleur reconnues par Qt (obtenue via QColor : : colorNames ( )). L'utilisateur peut saisir une 
chaine de filtre dans un QLineEdit et specifier la maniere dont cette chaine doit etre interpre- 
ted (comme une expression reguliere, un modele generique ou une chaine fixe) grace a une 
zone de liste deroulante (voir Figure 10.8). 

Figure 10.8 

L' application 
Color Names 
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Voici un extrait du constructeur deColorNamesDialog : 

ColorNamesDialog: :ColorNamesDialog(QWidget *parent) 
: QDialog(parent) 

{ 

sourceModel = new QStringListModel(this) ; 
sourceModel->setStringList (QColor : : colorNames ( ) ) ; 

proxyModel = new QSortFilterProxyModel(this) ; 
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proxyModel->setSourceModel(sourceModel) ; 
proxyModel->setFilterKeyColumn(0) ; 

listView = new QListView; 
listView->setModel(proxyModel) ; 

syntaxComboBox = new QComboBox; 

syntaxComboBox->addItem(tr( "Regular expression" ) , QRegExp: :RegExp) ; 
syntaxComboBox->addItem(tr( "Wildcard" ) , QRegExp: :Wildcard) ; 
syntaxComboBox->addItem(tr( "Fixed string") , QRegExp: :FixedString) ; 

} 

QStringListModel est cree et alimente de maniere habituelle. Puis, nous construisons 
QSortFilterProxyModel. Nous transmettons le modele sous-jacent a l'aide de setSource- 
Model ( ) et nous demandons au proxy de filtrer en se basant sur la colonne 0 du modele original. 
La fonction QComboBox : :addltem() recoit un argument facultatif "donnee" de type QVariant ; 
nous l'utilisons pour enregistrer la valeur QRegExp : : PatternSyntax qui correspond au texte 
de chaque element. 

void ColorNamesDialog: : reapplyFilter( ) 
{ 

QRegExp: : PatternSyntax syntax = 

QRegExp: :PatternSyntax(syntaxComboBox->itemData( 
syntaxComboBox->current Index ( ) ) .tolnt ( ) ) ; 
QRegExp regExp(f ilterLineEdit->text( ) , Qt: :CaseInsensitive, syntax); 
proxyModel->setFilterRegExp(regExp) ; 

} 

Le slot reapplyFilter ( ) est invoque des que l'utilisateur modifie la chaine de nitre ou la 
zone de liste deroulante correspondant au modele. Nous creons un QRegExp en utilisant le 
texte present dans l'editeur de lignes. Nous faisons ensuite correspondre la syntaxe de son 
modele a celle stockee dans les donnees de 1' element en cours dans la zone de liste deroulante 
relative a la syntaxe. Puis nous appelons setFilterRegExp( ), le nouveau nitre s'active et la 
vue est mise a jour automatiquement. 



Implementer des modeles personnalises 

Les modeles predefinis de Qt sont pratiques pour gerer et afncher des donnees. Cependant, 
certaines sources de donnees ne peuvent pas etre utilisees efncacement avec les modeles 
predefinis, c'est pourquoi il est parfois necessaire de creer des modeles personnalises optimises 
pour la source de donnees sous-jacente. 

Avant de commencer a creer des modeles personnalises, analysons d'abord les concepts essen- 
tiels utilises dans 1' architecture modele/vue de Qt. Chaque element de donnees dans un modele 
possede un index de modele et un ensemble d'attributs, appeles roles, qui peuvent prendre des 
valeurs arbitraires. Nous avons vu precedemment que les roles les plus couramment employes 



242 Qt4 et C++ : Programmation d'interfaces GUI 



sont Qt : :EditRole et Qt : : DisplayRole. D'autres roles sont utilises pour des donnees 
supplementaires (par exemple Qt : :ToolTipRole, Qt : : StatusTipRole et Qt::Whats- 
ThisRole) et d'autres encore pour controler les attributs d'affichage de base (tels que 
Qt : : FontRole, Qt : : TextAlignmentRole, Qt : :TextColorRole et Qt : : Background- 
ColorRole). 



Figure 10.9 
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Pour un modele liste, le seul composant d' index pertinent est le nombre de lignes, accessible 
depuis QModellndex : : row( ). Pour un modele de tableau, les composants d'index pertinents 
sont les nombres de lignes et de colonnes, accessibles depuis QModellndex :: row( ) et 
QModellndex : : column ( ). Pour les modeles liste et tableau, le parent de chaque element est 
la racine, qui est representee par un QModellndex invalide. Les deux premiers exemples de 
cette section vous montrent comment implementer des modeles de tableau personnalises. 

Un modele arborescence ressemble a un modele de tableau, a quelques differences pres. 
Comme un modele de tableau, la racine est le parent des elements de haut niveau (un QMode- 
llndex invalide), mais le parent de tout autre element est un autre element dans la hierarchie. 
Les parents sont accessibles depuis QModellndex: : parent (). Chaque element possede ses 
donnees de role et aucun ou plusieurs enfants, chacun etant un element en soi. Vu que les 
elements peuvent avoir d'autres elements comme enfants, il est possible de representer des 
structures de donnees recursives (a la facon d'une arborescence), comme vous le montrera le 
dernier exemple de cette section. 

Le premier exemple de cette section est un modele de tableau en lecture seule qui affiche des 
valeurs monetaires en relation les unes avec les autres (voir Figure 10.10). 

L application pourrait etre implementee a partir d'un simple tableau, mais nous voulons nous 
servir d'un modele personnalise pour profiter de certaines proprietes des donnees qui minimi- 
sent le stockage. Si nous voulions conserver les 162 devises actuellement cotees dans un 
tableau, nous devrions stacker 162 X 162 = 26 244 valeurs ; avec le modele personnalise 
presente ci-apres, nous n'enregistrons que 162 valeurs (la valeur de chaque devise par rapport 
au dollar americain). 
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Figure 10.10 
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La classe CurrencyModel sera utilisee avec un QTableView standard. Elle est alimentee avec 
un QMap<QString , double> ; chaque cle correspond au code de la devise et chaque valeur 
correspond a la valeur de la devise en dollars americains. Voici un extrait de code qui montre 
comment le tableau de correspondance est alimente et comment le modele est utilise : 

QMap<QString, double> currencyMap; 
currencyMap. insert ("AUD", 1 .3259) ; 
currencyMap. insert ("CHF", 1 .2970) ; 

currencyMap. insert ( "SGD" , 1 .6901 ) ; 
currencyMap. insert( "USD" , 1 .0000) ; 

CurrencyModel currencyModel; 
CurrencyModel. setCurrencyMap(currencyMap) ; 

QTableView tableView; 
tableView.setModel(&currencyModel) ; 
tableView. setAlternatingRowColors (true) ; 

Etudions desormais 1' implementation du modele, en commencant par son en-tete : 

class CurrencyModel : public QAbstractTableModel 
{ 

public: 

CurrencyModel(QObject *parent = 0); 

void setCurrencyMap(const QMap<QString, double> &map) ; 
int rowCount (const QModellndex &parent) const; 
int columnCount (const QModellndex &parent) const; 
QVariant data(const QModellndex &index, int role) const; 
QVariant headerData(int section, Qt: :Orientation orientation, 
int role) const; 

private: 

QString currencyAtfint offset) const; 
QMap<QString, double> currencyMap; 

}; 
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Nous avons choisi de deriver QAbstractTableModel pour notre modele, parce que cela 
correspond le plus a notre source de donnees. Qt propose plusieurs classes de base de modele, 
y compris QAbstractListModel, QAbstractTableModel et QAbstractltemModel (voir 
Figure 10.11). La classe QAbstractltemModel est employee pour supporter une grande 
variete de modeles, dont ceux qui se basent sur des structures de donnees recursives, alors que 
les classes QAbstractListModel et QAbstractTableModel sont proposees pour une question 
de commodite lors de 1' utilisation d' ensembles de donnees a une ou deux dimensions. 



Pour un modele de tableau en lecture seule, nous devons reimplementer trois fonctions : 
rowCount(), columnCount ( ) et data(). Dans ce cas, nous avons aussi reimplemente 
headerData( ) et nous fournissons une fonction pour initialiser les donnees (setCurrency- 
Map()). 

CurrencyModel: :CurrencyModel(QObject *parent) 
: QAbstractTableModel(parent) 

{ 
} 

Nous n' avons pas besoin de faire quoi que ce soit dans le constructeur, sauf transmettre le para- 
metre parent a la classe de base. 

int CurrencyModel: : rowCount( const QModellndex & /* parent */) const 
{ 

return currencyMap. count () ; 

} 

int CurrencyModel: :columnCount(const QModellndex & /* parent */) const 
{ 

return currencyMap. count() ; 

} 

Pour ce modele de tableau, les nombres de lignes et de colonnes correspondent aux nombres 
de devises dans le tableau de correspondance des devises. Le parametre parent n'a aucune 
signification pour un modele de tableau ; il est present parce que rowCount() et column- 
Count ( ) sont herites de la classe de base QAbstractltemModel plus generique, qui prend en 
charge les hierarchies. 

QVariant CurrencyModel: :data(const QModellndex Sindex, int role) const 
{ 

if (! index. isValid()) 
return QVariant () ; 



Figure 10.11 
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if (role == Qt : :TextAlignmentRole) { 

return int(Qt: :AlignRight | Qt : :AlignVCenter) ; 
} else if (role == Qt: :DisplayRole) { 

QString row/Currency = currencyAt(index.row()) ; 

QString columnCurrency = currencyAt (index. column( )) ; 

if (currencyMap. value(rowCurrency) == 0.0) 
return "####"; 

double amount = currencyMap. value(columnCurrency) 
/ currencyMap. value(rowCurrency) ; 

return QString( "%1 ") .arg(amount, 0, 'f, 4); 

} 

return QVariantf) ; 

} 

La fonction data() retourne la valeur de n'importe quel role d'un element. L'element est 
specifie sous forme de QModellndex. Pour un modele de tableau, les composants interessants 
d'un QModellndex sont ses nombres de lignes et de colonnes, disponibles grace a row() et 
column( ). 

Si le role est Qt : :TextAlignmentRole, nous retournons un alignement adapte aux nombres. 
Si le role d'affichage est Qt : : Display Role, nous recherchons la valeur de chaque devise et 
nous calculons le taux de change. 

Nous pourrions retourner la valeur calculee sous forme de type double, mais nous n'aurions 
aucun controle sur le nombre de chiffres apres la virgule (a moins d'utiliser un delegue person- 
nalise). Nous retournons done plutot la valeur sous forme de chaine, mise en forme comme 
nous le souhaitons. 

QVariant CurrencyModel: :headerData(int section, 

Qt : :Orientation /* orientation */, 
int role) const 

{ 

if (role != Qt: :DisplayRole) 

return QVariantf) ; 
return currencyAt(section) ; 

} 

La fonction headerData ( ) est appelee par la vue pour alimenter ses en-tetes verticaux et hori- 
zontaux. Le parametre section correspond au nombre de lignes ou de colonnes (selon l'orien- 
tation). Vu que les lignes et les colonnes ont les memes codes de devise, nous ne nous soucions 
pas de l'orientation et nous retournons simplement le code de la devise pour le numero de 
section donne. 

void CurrencyModel: :setCurrencyMap(const QMap<QString, double> &map) 
{ 

currencyMap = map; 
reset () ; 

} 
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L' appelant peut modifier le tableau de correspondance des devises en executant setCurren- 
cyMap(). Lappel de QAbstractltemModel :: reset ( ) informe n'importe quelle vue qui 
utilise le modele que toutes leurs donnees sont invalides ; ceci les oblige a demander des 
donnees actualisees pour les elements visibles. 

QString CurrencyModel: :currencyAt(int offset) const 
{ 

return (currencyMap.beginf ) + off set) . key ( ) ; 

} 

La fonction cu rr encyAt ( ) retourne la cle (le code de la devise) a la position donnee dans le 
tableau de correspondance des devises. Nous utilisons un iterateur de style STL pour trouver 
1' element et appeler key ( ) . 

Comme nous venons de le voir, il n'est pas difficile de creer des modeles en lecture seule, et en 
fonction de la nature des donnees sous-jacentes, il est possible d'economiser de la memoire et 
d'accelerer les temps de reponse avec un modele bien concu. Le prochain exemple, 1' applica- 
tion Cities, se base aussi sur un tableau, mais cette fois-ci les donnees sont saisies par l'utilisateur 
(voir Figure 10.12). 

Cette application est utilisee pour enregistrer des valeurs indiquant la distance entre deux 
villes. Comme l'exemple precedent, nous pourrions simplement utiliser un QTableWidget et 
stocker un element pour chaque paire de villes. Cependant, un modele personnalise pourrait 
etre plus efficace, parce que la distance entre une ville A et une ville B est la meme que vous 
alliez de A a B ou de B a A, les elements se refletent done le long de la diagonale principale. 

Pour voir comment un modele personnalise se compare a un simple tableau, supposons que 
nous avons trois villes, A, B et C. Si nous conservions une valeur pour chaque combinaison, 
nous devrions stocker neuf valeurs. Un modele bien concu ne necessiterait que trois elements 
(A, B), (A, C) et (B, C). 



Figure 10.12 
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Voici comment nous avons configure et exploite le modele : 
QStringList cities; 

cities « "Arvika" « "Boden" « "Eskilstuna" « "Falun" 

« "Filipstad" « "Halmstad" « "Helsingborg" « "Karlstad" 
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« "Kiruna" « "Kramfors" « "Motala" « "Sandviken" 

« "Skara" « "Stockholm" « "Sundsvall" « "Trelleborg" ; 

CityModel cityModel; 
cityModel. setCities(cities) ; 

QTableView tableView; 
tableView.setModel(&cityModel) ; 
tableView. setAlternatingRowColors (true) ; 

Nous devons reimplementer les memes fonctions que pour l'exemple precedent. De plus, nous 
devons aussi reimplementer setData( ) et flags ( ) pour que le modele puisse etre modifie. 
Voici la definition de classe : 

class CityModel : public QAbstractTableModel 
{ 

Q_0BJECT 
public: 

CityModel (QObject *parent = 0); 

void setCities(const QStringList &cityNames); 
int rowCount (const QModellndex &parent) const; 
int columnCount (const QModellndex &parent) const; 
QVariant data(const QModellndex &index, int role) const; 
bool setDatafconst QModellndex &index, const QVariant &value, 
int role) ; 

QVariant headerData(int section, Qt : :Orientation orientation, 

int role) const; 
Qt : : ItemFlags flags(const QModellndex &index) const; 

private: 

int offsetOffint row, int column) const; 

QStringList cities; 
QVector<int> distances; 

}; 

Pour ce modele, nous utilisons deux structures de donnees : cities de type QStringList 
pour contenir les noms de ville, et distances de type QVector<int> pour enregistrer la 
distance entre chaque paire unique de villes. 

CityModel: :CityModel(QObject *parent) 
: QAbstractTableModel (parent) 

{ 
} 

Le constructeur ne fait rien a part transmettre le parametre parent a la classe de base. 

int CityModel: : rowCount(const QModellndex & /* parent */) const 
{ 

return cities. count () ; 
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} 

int CityModel: :columnCount (const QModellndex & /* parent */) const 
{ 

return cities. count() ; 

} 

Vu que nous avons une grille carree de villes, le nombre de lignes et de colonnes correspond au 
nombre de villes de notre liste. 

QVariant CityModel: :data(const QModellndex &index, int role) const 
{ 

if (! index. isValid()) 
return QVariant () ; 

if (role == Qt: :TextAlignmentRole) { 

return int(Qt: :AlignRight | Qt : :AlignVCenter) ; 
} else if (role == Qt: :DisplayRole) { 

if (index. row() == index. column()) 
return 0; 

int offset = off setOf (index. row( ) , index. column()) ; 
return distances[off set] ; 

} 

return QVariant () ; 

} 

La fonction data ( ) est similaire a ce que nous effectue dans CurrencyModel. Elle retourne 0 
si la ligne et la colonne sont identiques, parce que cela correspond au cas ou les deux villes 
sont les memes ; sinon elle recherche 1' entree de la ligne et de la colonne dans le vecteur 
distances et renvoie la distance pour cette paire de villes particuliere. 

QVariant CityModel: :headerData(int section, 

Qt: :Orientation /* orientation */, 
int role) const 

{ 

if (role == Qt: :DisplayRole) 

return cities[section] ; 
return QVariant () ; 

} 

La fonction headerData( ) est simple puisque nous avons un tableau carre ou chaque ligne 
possede un en-tete de colonne identique. Nous retournons simplement le nom de la ville a la 
position donnee dans la liste de chaine cities. 

bool CityModel: :setData(const QModellndex &index, 

const QVariant &value, int role) 

{ 

if (index. isValid() && index. row() != index. column () 
&& role == Qt: :EditRole) { 
int offset = off setOf (index. row( ) , index. column()) ; 
distances[off set] = value. to!nt() ; 
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QModellndex transposedlndex = createIndex(index.column() , 

index. row( ) ) ; 

emit dataChanged(index, index); 

emit dataChangedjtransposedlndex, transposedlndex); 

return true; 

} 

return false; 

} 

La fonction setData ( ) est invoquee quand l'utilisateur modifie un element. En supposant que 
l'index de modele est valide, que les deux villes sont differentes et que l'element de donnees a 
modifier est Qt : :EditRole, la fonction stocke la valeur que l'utilisateur a saisie dans le 
vecteur distances. 

La fonction createlndex( ) sert a generer un index de modele. Nous en avons besoin pour 
obtenir l'index de modele de l'element symetrique de l'element configure par rapport a la 
diagonale principale, vu que les deux elements doivent afficher les memes donnees. La fonc- 
tion createlndex() recoit la ligne avant la colonne ; ici, nous inversons les parametres pour 
obtenir l'index de modele de l'element symetrique a celui specifie par index. 

Nous emettons le signal dataChanged ( ) avec l'index de modele de l'element qui a ete modifie. 
Ce signal recoit deux index de modele, parce qu'un changement peut affecter une region 
rectangulaire constitute de plusieurs lignes et colonnes. Les index transmis representent 
l'element situe en haut a gauche et l'element en bas a droite de la zone modifiee. Nous emet- 
tons aussi le signal dataChanged ( ) a l'attention de l'index transpose arm que la vue actualise 
l'affichage de l'element. Enfin, nous retournons true ou false pour indiquer si la modification a 
ete effectuee avec succes ou non. 

Qt: :ItemFlags CityModel: :flags(const QModellndex &index) const 
{ 

Qt : : ItemFlags flags = QAbstractltemModel: :flags(index) ; 
if (index. row() != index. column) ) ) 

flags |= Qt: : ItemlsEditable; 
return flags; 

} 

Le modele se sert de la fonction flags ( ) pour annoncer les possibilites d'action sur l'element 
(par exemple, s'il peut etre modifie ou non). L implementation par defaut de QAbstractTable- 
Model retourne Qt : : ItemlsSelectable | Qt : : ItemlsEnabled. Nous ajoutons l'indicateur 
Qt : : ItemlsEditable pour tous les elements sauf ceux qui se trouvent sur les diagonales (qui 
sont toujours nuls). 

void CityModel: :setCities(const QStringList &cityNames) 
{ 

cities = cityNames; 

distances. resize(cities.count() * (cities. countf ) - 1) / 2); 
distances. fill(0) ; 
reset () ; 

} 
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Si nous recevons une nouvelle liste de villes, nous definissons le QStringList prive en 
nouvelle liste, nous redimensionnons et nous effacons le vecteur distances puis nous appelons 
QAbstractltemModel : : reset () pour informer toutes les vues que leurs elements visibles 
doivent etre a nouveau recuperes. 

int CityModel: : off setoff int row, int column) const 
{ 

if (row < column) 

qSwapfrow, column); 
return (row * (row - 1) / 2) + column; 

} 

La fonction privee of f setOf ( ) calcule l'index d'une paire de villes donnee dans le vecteur 
distances. Par exemple, si nous avions les villes A, B, C et D et si l'utilisateur avait mis a 
jour la ligne 3, colonne 1, B a D, le decalage serait de 3 _ (3 - l)/2 + 1 = 4. Si l'utilisateur avait 
mis a jour la ligne 1, colonne 3, D a B, grace a qSwap ( ), exactement le meme calcul aurait ete 
accompli et un decalage identique aurait ete retourne. 

Figure 10.13 villes 

Les structures de donnees | a | B | C | D | 
cities et distances 
et le modele de tableau Distances 

\mb\a*-c\a+d\b+c\b+d\od 



Le dernier exemple de cette section est un modele qui presente l'arbre d' analyse d'une expres- 
sion reguliere donnee. Une expression reguliere est constitute d'un ou plusieurs termes, sepa- 
res par des caracteres "I". Lexpression reguliere "alphalbravolcharlie" contient done trois 
termes. Chaque terme est une sequence d'un ou plusieurs facteurs ; par exemple, le terme 
"bravo" est compose de cinq facteurs (chaque lettre est un facteur). Les facteurs peuvent 
encore etre decomposes en atome et en quantificateur facultatif, comme "*", "+" et "?".Vu que 
les expressions regulieres peuvent contenir des sous-expressions entre parentheses, les arbres 
d' analyse correspondants seront recursifs. 

Lexpression reguliere presentee en Figure 10.14, "abl(cd)?e", correspond a un 'a' suivi d'un 
'b', ou d'un 'c' suivi d'un 'd' puis d'un 'e', ou simplement d'un 'e'. Elle correspondra ainsi a 
"ab" et "cde", mais pas a "be" ou "cd". 

L application Regexp Parser se compose de quatre classes : 

• RegExpWindow est une fenetre qui permet a l'utilisateur de saisir une expression reguliere 
et qui affiche l'arbre d' analyse correspondant. 

• RegExpParser genere un arbre d'analyse a partir d'une expression reguliere. 

• RegExpModel est un modele d'arborescence qui encapsule un arbre d'analyse. 

• Node represente un element dans un arbre d'analyse. 
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Figure 10.14 
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Commencons par la classe Node : 

class Node 
{ 

public: 

enum Type { RegExp, Expression, Term, Factor, Atom, Terminal }; 



Node (Type type, const QString &str = ""); 
-Node(); 



Type type; 
QString str; 
Node *parent; 
QList<Node *> children; 

}; 

Chaque noeud possede un type, une chaine (qui peut etre vide), un parent (qui peut etre 0) et 
une liste de noeuds enfants (qui peut etre vide). 

Node: :Node(Type type, const QString &str) 
{ 

this->type = type; 
this->str = str; 
parent = 0; 

} 

Le constructeur initialise simplement le type et la chaine du noeud. Etant donne que toutes les 
donnees sont publiques, le code qui utilise Node peut operer directement sur le type, la chaine, 
le parent et les enfants. 

Node: :-Node() 
{ 

qDeleteAll(children) ; 

} 
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La fonction qDeleteAll ( ) parcourt un conteneur de pointeurs et appelle delete sur chacun 
d'eux. Elle ne definit pas les pointeurs en 0, done si elle est utilisee en dehors d'un destructeur, 
il est frequent de la voir suivie d'un appel de clear () sur le conteneur qui renferme les 
pointeurs. 

Maintenant que nous avons defini nos elements de donnees (chacun represents par un Node), 
nous sommes prets a creer un modele : 

class RegExpModel : public QAbstractltemModel 
{ 

public: 

RegExpModel(QObject *parent = 0); 
-RegExpModel( ) ; 

void setRootNode(Node *node); 

QModellndex index(int row, int column, 

const QModellndex &parent) const; 
QModellndex parent(const QModellndex &child) const; 

int rowCount (const QModellndex &parent) const; 
int columnCount (const QModellndex &parent) const; 
QVariant data(const QModellndex &index, int role) const; 
QVariant headerData(int section, Qt: :Orientation orientation, 
int role) const; 

private: 

Node *nodeFromIndex (const QModellndex Sindex) const; 
Node *rootNode; 

}; 

Cette fois-ci nous avons herite de QAbstractltemModel plutot que de sa sous-classe dediee 
QAbstractTableModel, parce que nous voulons creer un modele hierarchique. Les fonctions 
essentielles que nous devons reimplementer sont toujours les memes, sauf que nous devons 
aussi implementer index () et parent (). Pour definir les donnees du modele, une fonction 
setRootNode ( ) doit etre invoquee avec le noeud racine de l'arbre d'analyse. 

RegExpModel: :RegExpModel(QObject *parent) 
: QAbstractltemModel(parent) 

{ 

rootNode = 0; 

} 

Dans le constructeur du modele, nous n' avons qu'a configurer le noeud racine en valeur nulle et 
transmettre le parent a la classe de base. 

RegExpModel: :-RegExpModel( ) 
{ 

delete rootNode; 

} 
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Dans le destructeur, nous supprimons le nceud racine. Si le noeud racine a des enfants, chacun 
d'eux est supprime par le destructeur Node , et ainsi de suite de maniere recursive. 

void RegExpModel: :setRootNode(Node *node) 
{ 

delete rootNode; 
rootNode = node; 
reset)) ; 

} 

Quand un nouveau noeud racine est defini, nous supprimons d'abord tout noeud racine prece- 
dent (et tous ses enfants). Nous configurons ensuite le nouveau noeud racine et nous appelons 
reset () pour informer les vues qu'elles doivent a nouveau recuperer les donnees des 
elements visibles. 

QModellndex RegExpModel: :index(int row, int column, 

const QModellndex &parent) const 

{ 

if (! rootNode) 

return QModelIndex( ) ; 
Node *parentNode = nodeFromlndex(parent) 
return createlndexfrow, column, parentNode->children[ row] ) ; 

} 

La fonction index ( ) est reimplementee dans QAbstractltemModel. Elle est appelee des que 
le modele ou la vue doit creer un QModellndex pour un element enfant particulier (ou un 
element de haut niveau si parent est un QModellndex invalide). Pour les modeles de tableau 
et de liste, nous n'avons pas besoin de reimplementer cette fonction, parce que les imple- 
mentations par defaut de QAbstractListModel et QAbstractTableModel sont normalement 
suffisantes. 

Dans notre implementation d' index ( ), si aucun arbre d'analyse n'est configure, nous retour- 
nons un QModellndex invalide. Sinon, nous creons un QModellndex avec la ligne et la 
colonne donnees et avec un Node * pour l'enfant demande. S'agissant des modeles hierarchi- 
ques, il n'est pas suffisant de connaitre la ligne et la colonne d'un element par rapport a son 
parent pour 1' identifier ; nous devons aussi savoir qui est son parent. Pour resoudre ce 
probleme, nous pouvons stacker un pointeur vers le noeud interne dans le QModellndex. 
QModellndex nous permet de conserver un void * ou un int en plus des nombres de lignes 
et de colonnes. 

Le Node * de l'enfant est obtenu par le biais de la liste children du noeud parent. Le noeud 
parent est extrait de 1' index de modele parent grace a la fonction privee nodeFromlndex ( ) : 

Node *RegExpModel: :nodeFromIndex(const QModellndex &index) const 
{ 

if (index.isValidO) { 

return static_cast<Node *>(index.internalPointer()) ; 
} else { 

return rootNode; 

} 

} 
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La fonction nodeFromlndex ( ) convertit le void * de l'index donne en Node * ou retourne le 
noeud racine si l'index est invalide, puisqu'un index de modele invalide represente la racine 
dans un modele. 

int RegExpModel: : rowCount (const QModellndex &parent) const 
{ 

Node *parentNode = nodeFromlndex(parent) ; 
if ( IparentNode) 
return 0; 

return parentNode->children.count() ; 

} 

Le nombre de lignes d'un element particulier correspond simplement au nombre d'enfants 
qu'il possede. 

int RegExpModel: :columnCount(const QModellndex & /* parent */) const 
{ 

return 2; 

} 

Le nombre de colonnes est fixe a 2. La premiere colonne contient les types de nceuds ; la 
seconde comporte les valeurs des noeuds. 

QModellndex RegExpModel: :parent(const QModellndex &child) const 
{ 

Node *node = nodeFromlndex ( child ) ; 
if (Inode) 

return QModellndex) ) ; 
Node *parentNode = node->parent; 
if (IparentNode) 

return QModelIndex( ) ; 
Node *grandparentNode = parentNode->parent; 
if ( IgrandparentNode) 

return QModellndex) ) ; 

int row = grandparentNode->children.indexOf (parentNode) ; 
return createIndex(row, child. column) ) , parentNode); 

} 

Recuperer le parent QModellndex d'un enfant est un peu plus complexe que de rechercher 
l'enfant d'un parent. Nous pouvons facilement recuperer le noeud parent a l'aide de nodeFrom- 
lndex ( ) et poursuivre en utilisant le pointeur du parent de Node, mais pour obtenir le numero 
de ligne (la position du parent parmi ses pairs), nous devons remonter jusqu'au grand-parent et 
rechercher la position d'index du parent dans la liste des enfants de son parent (c'est-a-dire 
celle du grand-parent de l'enfant). 

QVariant RegExpModel: :data(const QModellndex &index, int role) const 
{ 

if (role != Qt: :DisplayRole) 
return QVariant () ; 
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Node *node = nodeFromlndex(index) ; 
if (Inode) 

return QVariant() ; 

if (index. columnf) == 0) { 
switch (node->type) { 
case Node: :RegExp: 

return tr( "RegExp" ) ; 
case Node: Expression : 

return tr("Expression") ; 
case Node: :Term: 

return tr( "Term" ) ; 
case Node: :Factor: 

return tr( "Factor" ) ; 
case Node: :Atom: 

return tr( "Atom" ) ; 
case Node: :Terminal: 

return tr( "Terminal" ) ; 
default: 

return tr( "Unknown" ) ; 

} 

} else if (index. column() == 1 ) { 
return node->str; 

} 

return QVariant)) ; 

} 

Dans data ( ) , nous recuperons le Node * de l'element demande et nous nous en servons pour 
acceder aux donnees sous-jacentes. Si 1' appelant veut une valeur pour n'importe quel role 
excepte Qt: :DisplayRole ou s'il ne peut pas recuperer un Node pour l'index de modele 
donne, nous retournons un QVariant invalide. Si la colonne est 0, nous renvoyons le nom du 
type du noeud ; si la colonne est 1, nous retournons la valeur du noeud (sa chaine). 

QVariant RegExpModel: : headerDatafint section, 

Qt: :0rientation orientation, 
int role) const 

{ 

if (orientation == Qt: horizontal && role == Qt: :DisplayRole) { 
if (section == 0) { 

return tr( "Node" ) ; 
} else if (section == 1 ) { 

return tr( "Value" ) ; 

} 

} 

return QVariant () ; 

} 
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Dans notre reimplementation de headerData( ), nous retournons les intitules appropries des 
en-tetes horizontaux. La classe QTreeView, qui est employee pour visualiser des modeles 
hierarchiques, ne possede pas d'en-tete vertical, nous ignorons done cette eventualite. 

Maintenant que nous avons etudie les classes Node et RegExpModel, voyons comment le nceud 
racine est cree quand l'utilisateur modifie le texte dans l'editeur de lignes : 

void RegExpWindow: : regExpChanged(const QString &regExp) 
{ 

RegExpParser parser; 

Node *rootNode = parser. parse(regExp) ; 

regExpModel->setRootNode(rootNode) ; 

} 

Quand l'utilisateur change le texte dans l'editeur de lignes de 1' application, le slot regExp- 
Changed ( ) de la fenetre principale est appele. Dans ce slot, le texte de l'utilisateur est analyse 
et l'analyseur retourne un pointeur vers le noeud racine de l'arbre d' analyse. 

Nous n'avons pas etudie la classe RegExpParser parce qu'elle n'est pas pertinente pour les 
interfaces graphiques ou la programmation modele/vue. Le code source complet de cet exemple 
se trouve sur la page dediee a cet ouvrage sur le site web de Pearson, www.pearson.fr. 

Dans cette section, nous avons vu comment creer trois modeles personnalises differents. De 
nombreux modeles sont beaucoup plus simples que ceux presentes ici, avec des correspondan- 
ces uniques entre les elements et les index de modele. D'autres exemples modele/vue sont 
fournis avec Qt, accompagnes d'une documentation detaillee. 



Implementer des delegues personnalises 

Les elements individuels dans les vues sont affiches et modifies a l'aide de delegues. Dans la 
majorite des cas, le delegue par defaut propose par une vue s'avere suffisant. Si nous voulons 
controler davantage l'affichage des elements, nous pouvons atteindre notre objectif simple- 
ment en utilisant un modele personnalise : dans notre reimplementation de data(), nous 
avons la possibilite de gerer Qt : :FontRole, Qt: :TextAlignmentRole, Qt: :TextColor- 
Role et Qt : : BackgroundColorRole et ceux-ci sont employes par le delegue par defaut. Par 
exemple, dans les exemples Cities et Currencies presentes auparavant, nous avons gere 
Qt : : TextAlignmentRole pour obtenir des nombres justifies a droite. 

Si nous voulons encore plus de controle, nous pouvons creer notre propre classe de delegue et 
la definir sur les vues qui l'utiliseront. La boite de dialogue Track Editor illustree en 
Figure 10.15 est basee sur un delegue personnalise. Elle affiche les titres des pistes de musique 
ainsi que leur duree. Les donnees stockees dans le modele seront simplement des QString 
(pour les titres) et des int (pour les secondes), mais les durees seront divisees en minutes et en 
secondes et pourront etre modifiees a l'aide de QTimeEdit. 
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t Track Editor 



Figure 10.15 

La boite de dialogue 
Track Editor 





Track 


Duration 




1 


The Flying Dutchman: Overture 


10:30 




* 


The Flying Dutchman: Wie aus der Fern laengst vergangn ... 


06:14 




3 


The Flying Dutchman: Steuermann. lass die Wacht 


02:32 Z 




4 


Die Walkuere: Flide of the Valkynes 


04:46 




5 


Tannhaeuser: Freudig begruessen wir die edle Halle 


06:24 


v 



La boite de dialogue Track Editor se sert d'un QTableWidget, une sous-classe dediee a l'affi- 
chage d'elements qui agit sur des QTableWidget Item. Les donnees sont proposees sous 
forme d 'une liste de Track : 

class Track 
{ 

public: 

Track(const QString &title = "", int duration = 0); 

QString title; 
int duration; 

}; 

Voici un extrait du constructeur qui presente la creation et 1' alimentation en donnees du widget 
tableau : 

TrackEditor: :TrackEditor(QList<Track> *tracks, QWidget *parent) 
: QDialog(parent) 

{ 

this->tracks = tracks; 

tableWidget = new QTableWidget(tracks->count() , 2); 
tableWidget->setItemDelegate(new TrackDelegate(1 ) ) ; 
tableWidget->setHorizontalHeaderLabels( 

QStringList() « trf'Track") « tr( "Duration" )) ; 

for (int row = 0; row < tracks->count() ; ++row) { 
Track track = tracks->at(row) ; 



QTableWidgetltem *item0 = new QTableWidgetItem(track. title) ; 
tableWidget->setItem(row, 0, item0); 

QTableWidgetltem *item1 

= new QTableWidgetItem(QString: :number(track. duration) ) ; 
item1->setTextAlignment(Qt: :AlignRight) ; 
tableWidget->setItem(row, 1, iteml); 



} 
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Le constructeur cree un widget tableau et au lieu d'utiliser simplement le delegue par defaut, 
nous definissons notre TrackDelegate personnalise, lui transmettant la colonne qui contient 
les donnees de temps. Nous conrigurons d'abord les en-tetes des colonnes, puis nous parcourons 
les donnees, en alimentant les lignes avec le nom et la duree de chaque piste. 

Le reste du constructeur et de la boite de dialogue TrackEditor ne presentent aucune particula- 
rite, nous allons done analyser maintenant le TrackDelegate qui gere le rendu et la modification 
des donnees de la piste. 

class TrackDelegate : public QltemDelegate 
{ 

Q_0BJECT 
public: 

TrackDelegatefint durationColumn, QObject *parent = 0); 

void paint(QPainter *painter, const QStyleOptionViewItem &option, 

const QModellndex &index) const; 
QWidget *createEditor(QWidget *parent, 

const QStyleOptionViewItem Soption, 
const QModellndex &index) const; 
void setEditorData(QWidget *editor, const QModellndex &index) const; 
void setModelData (QWidget *editor, QAbstractltemModel *model, 
const QModellndex &index) const; 

private slots: 

void commitAndCloseEditor() ; 

private: 

int durationColumn; 

}; 

Nous utilisons QltemDelegate comme classe de base afin de beneficier de 1' implementation 
du delegue par defaut. Nous aurions aussi pu utiliser QAbstractltemDelegate si nous avions 
voulu tout commencer a zero. Pour proposer un delegue qui peut modifier des donnees, nous 
devons implementer createEditor ( ), set Edit orData ( ) et setModelData ( ). Nous imple- 
mentons aussi paint ( ) pour modifier l'affichage de la colonne de duree. 

TrackDelegate: :TrackDelegate(int durationColumn, QObject *parent) 
: QltemDelegate(parent) 

{ 

this->durationColumn = durationColumn; 

} 

Le parametre durationColumn du constructeur indique au delegue quelle colonne contient la 
duree de la piste. 

void TrackDelegate: : paint (QPainter *painter, 

const QStyleOptionViewItem &option, 
const QModellndex &index) const 

{ 

if (index. columnf) == durationColumn) { 

int sees = index. model( )->data(index, Qt: :DisplayRole) .toInt( ) ; 
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QString text = QString( "%1 :%2" ) 

.arg(secs / 60, 2, 10, QChar { ' 0 1 ) ) 
.arg(secs % 60, 2, 10, QChar('O')); 

QStyleOptionViewItem myOption = option; 

myOption .displayAlignment = Qt : :AlignRight | Qt: :AlignVCenter; 

drawDisplay (painter, myOption, myOption. rect, text); 
drawFocus(painter, myOption, myOption. rect) ; 
} else{ 

QltemDelegate: :paint(painter, option, index); 

} 

} 

Vu que nous voulons afficher la duree sous la forme "minutes : secondes" nous avons reim- 
plements la fonction paint ( ). Les appels de arg( ) recoivent un nombre entier a afficher 
sous forme de chaine, la quantite de caracteres que la chaine doit contenir, la base de Tender 
(10 pour un nombre decimal) et le caractere de remplissage. 

Pour justifier le texte a droite, nous copions les options de style en cours et nous remplacons 
l'alignement par defaut. Nous appelons ensuite QltemDelegate: :drawDisplay( ) pour 
dessiner le texte, suivi de QltemDelegate : : drawFocus ( ) qui tracera un rectangle de focus si 
l'element est actif et ne fera rien dans les autres cas. La fonction drawDisplay ( ) se revele tres 
pratique, notamment avec nos propres options de style. Nous pourrions aussi dessiner directement 
en utilisant le painter. 

QWidget *TrackDelegate: :createEditor(QWidget *parent, 
const QStyleOptionViewItem &option, 
const QModellndex &index) const 

{ 

if (index. column) ) == durationColumn) { 

QTimeEdit *timeEdit = new QTimeEdit(parent) ; 

timeEdit->setDisplayFormat( "mm:ss" ) ; 

connect (timeEdit, SIGNAL ( editingFinished ( ) ) , 
this, SLOT(commitAndCloseEditor( ) ) ) ; 

return timeEdit; 
} else { 

return QltemDelegate: :createEditor(parent, option, index); 

} 

} 

Nous ne voulons modifier que la duree des pistes, le changement des noms de piste reste a la 
charge du delegue par defaut. Pour ce faire, nous verifions pour quelle colonne un editeur a ete 
demande au delegue. S'il s'agit de la colonne de duree, nous creons un QTimeEdit, nous defi- 
nissons le format d'affichage de maniere appropriee et nous relions son signal editing- 
Finished ( ) a notre slot commitAndCloseEditor ( ). Pour toute autre colonne, nous cedons 
la gestion des modifications au delegue par defaut. 

void TrackDelegate: :commitAndCloseEditor() 
{ 
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QTimeEdit *editor = qobject_cast<QTimeEdit *>(sender()) ; 
emit commitData ( editor ) ; 
emit closeEditor(editor) ; 

} 

Si l'utilisateur appuie sur Entree ou deplace le focus hors du QTimeEdit (mais pas s'il appuie 
sur Echap), le signal editingFinished ( ) est emis et le slot commitAndCloseEditor( ) est 
invoque. Ce slot emet le signal commitData () pour informer la vue qu'il y a des donnees 
modifiees qui remplacent les donnees existantes. II emet aussi le signal closeEditor ( ) pour 
informer la vue que cet editeur n'est plus requis, le modele le supprimera done. L'editeur est 
recupere a l'aide de QObject: : sender () qui retourne l'objet qui a emis le signal qui a 
declenche le slot. Si l'utilisateur annule (en appuyant sur Echap), la vue supprimera simplement 
l'editeur. 

void TrackDelegate: :setEditorData(QWidget *editor, 

const QModellndex Sindex) const 

{ 

if (index. columnf) == durationColumn) { 

int sees = index. model ()->data( index, Qt: :DisplayRole) .toInt() ; 

QTimeEdit *timeEdit = qobject_cast<QTimeEdit *>(editor); 

timeEdit->setTime(QTime(0, sees / 60, sees % 60)); 
} else { 

QltemDelegate: :setEditorData(editor, index) ; 

} 

} 

Quand l'utilisateur initie une modification, la vue appelle createEditor ( ) pour creer un 
editeur, puis setEditorData ( ) pour initialiser l'editeur avec les donnees en cours de l'element. 
Si l'editeur concerne la colonne de duree, nous extrayons la duree de la piste en secondes et 
nous definissons le temps de QTimeEdit avec le nombre correspondant de minutes et de secondes ; 
sinon nous laissons le delegue par defaut s'occuper de 1' initialisation. 

void TrackDelegate: :setModelData(QWidget *editor, 

QAbstractltemModel *model, 
const QModellndex &index) const 

{ 

if (index. column) ) == durationColumn) { 

QTimeEdit *timeEdit = qobject_cast<QTimeEdit *>(editor); 

QTime time = timeEdit->time() ; 

int sees = (time. minute () * 60) + time.secondf) ; 

model->setData( index, sees); 
} else { 

QltemDelegate: :setModelData(editor, model, index); 

} 

} 

Si l'utilisateur termine la modification (par exemple en cliquant en dehors du widget ou en 
appuyant sur Entree ou Tab) au lieu de l'annuler, le modele doit etre mis a jour avec les 
donnees de l'editeur. Si la duree a change, nous extrayons les minutes et les secondes du 
QTimeEdit et nous configurons les donnees avec le nombre equivalent en secondes. 
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Meme si ce n'est pas necessaire dans ce cas, il est tout a fait possible de creer un delegue 
personnalise qui controle etroitement la modification et l'affichage de n'importe quel element 
d'un modele. Nous avons choisi de nous occuper d'une colonne particuliere, mais vu que 
QModellndex est transmis a toutes les fonctions de QltemDelegate que nous reimplemen- 
tons, nous pouvons prendre le controle par colonne, ligne, zone rectangulaire, parent ou toute 
combinaison de ceux-ci jusqu'aux elements individuels si necessaire. 

Dans ce chapitre, nous vous avons presente un large apercu de 1' architecture modele/vue de Qt. 
Nous avons vu comment utiliser les sous-classes dediees a l'affichage et les modeles predefinis 
de Qt et comment creer des modeles et des delegues personnalises. Toutefois, 1' architecture 
modele/vue est si riche que nous n'aurions pas suffisamment de place pour traiter tous ses 
aspects. Par exemple, nous pourrions creer une vue personnalisee qui n'affiche pas ses 
elements sous forme de liste, de tableau ou d'arborescence. C'est ce que propose l'exemple 
Chart situe dans le repertoire examples/itemviews/chart de Qt, qui presente une vue personna- 
lisee affichant des donnees du modele sous forme de graphique a secteurs. 

II est egalement possible d'employer plusieurs vues pour afficher le meme modele sans mise 
en forme. Toute modification effectuee via une vue se refletera automatiquement et immediate - 
ment dans les autres vues. Ce type de fonctionnalite est particulierement utile pour afficher de 
grands ensembles de donnees ou l'utilisateur veut voir des sections de donnees qui sont logi- 
quement eloignees les unes des autres. L' architecture prend en charge les selections : quand 
deux vues ou plus utilisent le meme modele, chaque vue peut etre definie de maniere a avoir 
ses propres selections independantes, ou alors les selections peuvent se repartir entre les vues. 

La documentation en ligne de Qt aborde la programmation d'affichage d'elements et les classes 
qui l'implementent. Consultez le site http://doc.trolltech.eom/4.l/model-view.html pour 
obtenir une liste des classes pertinentes et http://doc.trolltech.eom/4.l/model-vieW" 
programming.html pour des informations supplementaires et des liens vers les exemples 
fournis avec Qt. 
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Au sommaire de ce chapitre 

: Conteneurs sequentiels 
Conteneurs associatifs 
\/ Algorithmes generiques 
}/ Chaines, tableaux d' octets et variants 



Les classes conteneur sont des classes template polyvalentes qui stockent des elements 
d'un type donne en memoire. C++ offre deja de nombreux conteneurs dans la STL 
{Standard Template Library), qui est incluse dans la bibliotheque C++ standard. 

Qt fournissant ses propres classes conteneur, nous pouvons utiliser a la fois les conte- 
neurs STL et Qt pour les programmes Qt. Les conteneurs Qt presentent l'avantage de se 
comporter de la meme facon sur toutes les plates-formes et d'etre partages implicite- 
ment. Le partage implicite, ou la technique de "copie a l'ecriture", est une optimisation 
qui permet la transmission de conteneurs entiers comme valeurs sans cout significatif 
pour les performances. Les conteneurs Qt comportent egalement des classes d'iterateurs 
simple d'emploi inspirees par Java. Elles peuvent etre diffusees au moyen d'un 
QDataStream et elles necessitent moins de code dans l'executable que les conteneurs 
STL correspondants. Enfin, sur certaines plates-formes materielles supportees par 
Qtopia Core (la version Qt pour peripheriques mobiles), les conteneurs Qt sont les seuls 
disponibles. 
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Qt offre a la fois des conteneurs sequentiels tels que QVector<T>, QLinkedList<T> et 
QList<T> et des conteneurs associatifs comme QMap<K, T> et QHash<K, T>. Logiquement, les 
conteneurs sequentiels stockent les elements les uns apres les autres, alors que les conteneurs 
associatifs stockent des paires cle/valeur. 

Qt fournit egalement des algorithmes generiques qui realisent des operations sur les conte- 
neurs. Par exemple, l'algorithme qSort() trie un conteneur sequentiel et qBinaryFind ( ) 
effectue une recherche binaire sur un conteneur sequentiel trie. Ces algorithmes sont similaires 
a ceux offerts par la STL. 

Si vous etes deja familier avec les conteneurs de la STL et si vous disposez de cette bibliothe- 
que sur vos plates-formes cibles, vous pouvez les utiliser a la place ou en plus des conteneurs 
Qt. Pour plus d' informations au sujet des fonctions et des classes de la STL, rendez-vous sur le 
site Web de SGI a l'adresse http://www.sgi.com/tech/stl/. 

Dans ce chapitre, nous etudierons egalement les classes QString, QByteArray et QVariant, 
qui ont toutes de nombreux points en commun avec les conteneurs. QString est une chaine 
Unicode 16 bits utilisee dans l'API de Qt. QByteArray est un tableau de caracteres de 8 bits 
utilise pour stacker des donnees binaires brutes. QVariant est un type susceptible de stocker la 
plupart des types de valeurs Qt et C++. 



Conteneurs sequentiels 



Un QVector<T> est une structure de donnees de type tableau qui stocke ses elements a des 
emplacements adjacents en memoire. Un vecteur se distingue d'un tableau C++ brut par le fait 
qu'il connait sa propre taille et peut etre redimensionne. Lajout d'elements supplementaires a 
la fin d'un vecteur est assez efficace, alors que l'insertion d'elements devant ou au milieu de 
celui-ci peut s'averer couteux. (voir Figure 11.1) 

Figure 11.1 

Un vecteur d'elements 
de type double 



0 


1 


2 


3 


4 


937.81 


25.984 


308.74 


310.92 


40.9 



Si nous savons a l'avance combien d'elements nous seront necessaires, nous pouvons attri- 
buer au vecteur une taille initiale lors de sa definition et utiliser l'operateur [ ] pour affecter 
une valeur aux elements. Dans le cas contraire, nous devons redimensionner le vecteur ulte- 
rieurement ou aj outer les elements. Voici un exemple dans lequel nous specifions la taille 
initiale : 



QVector<double> vect(3); 
vect[0] =1.0; 
vect[1] = 0.540302; 
vect[2] = -0.416147; 
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Voici le meme exemple, commencant cette fois avec un vecteur vide et utilisant la fonction 
append ( ) pour aj outer des elements a la fin : 

QVector<double> vect; 
vect. append (1 .0) ; 
vect. append(0. 540302) ; 
vect. append (-0.41 61 47) ; 

Nous pouvons egalement remplacer append ( ) par 1' operate ur « : 

vect « 1.0 « 0.540302 « -0.416147; 

Vous parcourez les elements du vecteur a l'aide de [] et count ( ) : 
double sum = 0.0; 

for (int i = 0; i < vect.count() ; ++i) 
sum += vect[i] ; 

Les entrees de vecteur creees sans qu'une valeur explicite ne leur soit attribuee sont initialisees 
au moyen du constructeur par defaut de la classe de l'element. Les types de base et les types 
pointeur sont initialises en zero. 

L' insertion d'elements au debut ou au milieu d'un QVector<T>, ou la suppression d'elements 
a ces emplacements, risque de ne pas etre efficace pour de gros vecteurs. C'est pourquoi Qt 
offre egalement QLinkedList<T>, une structure de donnees qui stocke ses elements a des 
emplacements non adjacents en memoire. Contrairement aux vecteurs, les listes chainees ne 
prennent pas en charge Faeces aleatoire, mais elles garantissent les performances des insertions et 
des suppressions. (Voir Figure 11.2) 



937.81 




25.984 




308.74 




310.92 




40.9 



Figure 11.2 

Une liste chatnee d'elements de type double 



Les listes chainees ne fournissent pas l'operateur [ ]. II est done necessaire de recourir aux 
iterateurs pour parcourir leurs elements. Les iterateurs sont egalement utilises pour specifier la 
position des elements. Par exemple, le code suivant insere la chaine "Tote Hosen" entre 
"Clash" et "Ramones" : 

QLinkedList<QString> list; 
list.append("Clash") ; 
list. appendf "Ramones" ) ; 



QLinkedList<QString>: : iterator i 
list.insert(i, "Tote Hosen" ) ; 



list. find( "Ramones" ] 



Nous etudierons les iterateurs en detail ulterieurement dans cette section. 



266 Qt4 et C++ : Programmation d'interfaces GUI 



Le conteneur sequentiel QList<T> est une "liste-tableau" qui combine les principaux avanta- 
ges de QVector<T> et de QLinkedList<T> dans une seule classe. II prend en charge l'acces 
aleatoire et son interface est basee sur les index, de la meme facon que celle de QVector. 
L'ajout ou la suppression d'un element a une extremite d'un QList<T> est tres rapide. En 
outre, une insertion au sein d'une liste contenant jusqu'a un millier d'elements est egalement 
tres simple. A moins que nous souhaitions realiser des insertions au milieu de listes de taille 
tres importante ou que nous ayons besoin que les elements de la liste occupent des adresses 
consecutives en memoire, QList<T> constitue generalement la classe conteneur polyvalente la 
plus appropriee. La classe QSt ring List est une sous-classe de QList<QString> qui est 
largement utilisee dans l'API de Qt. En plus des fonctions qu'elle herite de sa classe de base, 
elle fournit des fonctions supplementaires qui la rendent plus souple d'emploi pour la gestion 
de chaine. QStringList est etudiee dans la derniere section de ce chapitre. 

QStack<T> et QQueue<T> sont deux exemples supplementaires de sous-classes utilitaires. 
QStack<T> est un vecteur qui fournit push ( ) , pop ( ) et top ( ) . QQueue<T> est une liste qui 
fournit enqueue ( ) , dequeue ( ) et head ( ) . 

Pour toutes les classes conteneur rencontrees jusqu'a present, le type de valeur T peut etre un 
type de base tel que int ou double, un type pointeur ou une classe qui possede un construc- 
teur par defaut (un constructeur qui ne recoit aucun argument), un constructeur de copie et un 
operateur d' affectation. Les classes qui remplissent les conditions requises incluent QByte- 
Array, QDateTime, QRegExp, QSt ring et QVariant. Les classes Qt qui heritent de QObject 
s'averent inadequates, car il leur manque un constructeur de copie et un operateur d'affecta- 
tion. Ceci ne pose pas de probleme dans la pratique, car nous pouvons simplement stocker des 
pointeurs vers des types QOb j ect plutot que les objets eux-memes. 

Le type de valeur T peut egalement etre un conteneur, auquel cas nous devons separer deux 
crochets consecutifs par des espaces. Sinon, le compilateur butera sur ce qu'il pense etre un 
operateur ». Par exemple : 

QList<QVector<double> > list; 

En plus des types que nous venons de mentionner, le type de valeur d'un conteneur peut etre 
toute classe personnalisee correspondant aux criteres decrits precedemment. Voici un exemple 
de classe de ce type : 

class Movie 
{ 

public: 

Movie(const QString &title = "", int duration = 0); 

void setTitle(const QString &title) { myTitle = title; } 
QString title() const { return myTitle; } 
void setDuration(int duration) { myDuration = duration; } 
QString duration() const { return myDuration; } 
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private: 

QString myTitle; 
int myDuration; 

}; 

La classe possede un constructeur qui n'exige aucun argument (bien qu'il puisse en recevoir 
jusqu'a deux). Elle possede egalement un constructeur de copie et un operateur d' affectation, 
tous deux etant implicitement fournis par C++. Pour cette classe, la copie au membre par 
membre est suffisante. II n'est done pas necessaire d'implementer votre propre constructeur de 
copie et votre operateur d' affectation. 

Qt fournit deux categories d'iterateurs afin de parcourir les elements stockes dans un conte- 
neur. Les iterateurs de style Java et ceux de style STL. Les iterateurs de style Java sont plus 
faciles a utiliser, alors que ceux de style STL sont plus puissants et peuvent etre combines avec 
les algorithmes generiques de Qt et de STL. 

Pour chaque classe conteneur, il existe deux types d'iterateurs de style Java : un iterateur en 
lecture seulement et un iterateur en lecture-ecriture. Les classes d'iterateur en lecture seule- 
ment sont QVectorIterator<T>, QLinkedListIterator<T> et QListIterator<T>. Les 
iterateurs en lecture/ecriture correspondants comportent le terme Mutable dans leur nom (par 
exemple, QMutableVectorIterator<T>). Dans cette discussion, nous allons surtout etudier 
les iterateurs de QList ; les iterateurs pour les listes chainees et les vecteurs possedent la 
me me API. (Voir Figure 11.3) 



Figure 11.3 

Emplacements valides 
pour les iterateurs 
de style Java 
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Le premier point a garder a l'esprit lors de l'utilisation d'iterateurs de style Java est qu'ils ne 
pointent pas directement vers des elements. lis peuvent etre situes avant le premier element, 
apres le dernier ou entre deux. Voici la syntaxe d'une boucle d'iteration typique : 

QList<double> list; 

QListIterator<double> i(list); 
while (i.hasNextf) ) { 

do_something ( i . next ( ) ) ; 

} 

L iterateur est initialise avec le conteneur a parcourir. A ce stade, 1' iterateur est situe juste avant 
le premier element. L'appel a hasNext ( ) retourne true si un element se situe sur la droite de 
1' iterateur. La fonction next ( ) retourne 1' element situe sur la droite de 1' iterateur et avance ce 
dernier jusqu'a la prochaine position valide. 
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L'iteration vers l'arriere est similaire, si ce n'est que nous devons tout d'abord appeler 
toBack ( ) pour placer l'iterateur apres le dernier element : 

QListIterator<double> i(list); 
i.toBackf ) ; 

while (i.hasPrevious()) { 

do_something (i. previous ( ) ) ; 

} 

La fonction hasPrevious ( ) retourne true si un element se trouve sur la gauche de l'itera- 
teur ; previous ( ) retourne cet element et le deplace vers l'arriere. Les iterateurs next ( ) et 
previous ( ) retournent l'element que l'iterateur vient de passer. (Voir Figure 1 1.4). 



Figure 11.4 

Effet de previous ( ) 

et de next( ) sur 

un itemteur de style Java 
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Les iterateurs mutables fournissent des fonctions destinees a inserer, modifier et supprimer des 
elements lors de l'iteration. La boucle suivante supprime tous les nombres negatifs d'une liste : 

QMutableListIterator<double> i(list) ; 
while (i.hasNextf) ) { 
if (i.next() < 0.0) 
i. remove () ; 

} 

La fonction remove ( ) opere toujours sur le dernier element passe. Elle fonctionne egalement 
lors de l'iteration vers l'arriere. 

QMutableListIterator<double> i(list) ; 
i.toBackf ) ; 

while (i.hasPrevious()) { 
if (i. previous)) < 0.0) 
i. remove) ) ; 

} 

De la meme facon, les iterateurs mutables de style Java fournissent une fonction setValue ( ) 
qui modifie le dernier element passe. Voici comment nous remplacerions des nombres negatifs 
par leur valeur absolue : 

QMutableListIterator<double> i(list) ; 
while (i.hasNextf) ) { 

int val = i.next() ; 

if (val < 0.0) 

i.setValue(-val) ; 

} 
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II est egalement possible d'inserer un element a 1' emplacement courant de l'iterateur en appe- 
lant insert ( ) . L'iterateur est alors avance a l'emplacement se situant entre le nouvel element 
et 1' element suivant. 

En plus des iterateurs de style Java, chaque classe conteneur sequentiel C<T> possede deux 
types d'iterateurs de style STL : C<T> : : iterator et C<T> : : const_iterator. La difference 
entre les deux est que const_iterator ne nous permet pas de modifier les donnees. 

La fonction begin ( ) d'un conteneur retourne un iterateur de style STL faisant reference au 
premier element du conteneur (par exemple list[0]), alors que end( ) retourne un iterateur 
pointant vers l'element suivant le dernier (par exemple, list [ 5 ] pour une liste de taille 5). Si 
un conteneur est vide, begin ( ) est egal a end ( ) . Cette caracteristique peut etre utilisee pour 
determiner si le conteneur comporte des elements, bien qu'il soit generalement plus approprie 
d'appeler isEmpty ( ) a cette fin. (Voir Figure 1 1.5) 
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La syntaxe d'un iterateur de style STL est modelee sur celle des pointeurs C++ dans un 
tableau. Nous pouvons utiliser les operateurs ++ et -- pour passer a l'element precedent ou 
suivant et l'operateur * unaire pour recuperer l'element en cours. Pour QVector<T>, l'iterateur 
et les types const_iterator sont simplement des typedefs de T* et constT*. (Ceci est possi- 
ble parce que QVector<T> stocke ses elements dans des emplacements consecutifs en 
me moire.) 

L' exemple suivant remplace chaque valeur d'un QList<double> par sa valeur absolue : 

QList<double>: :iterator i = list . begin( ) ; 
while (i != list.endO) { 

*i = qAbs(*i) ; 

++i; 

} 

Quelques fonctions Qt retournent un conteneur. Si nous voulons parcourir la valeur de retour 
d'une fonction au moyen d'un iterateur de style STL, nous devons prendre une copie du conte- 
neur et parcourir cette copie. Le code suivant, par exemple, illustre comment parcourir correctement 
le QList<int> retourne par QSplitter :: sizes () : 

QList<int> list = splitter->sizes( ) ; 
QList<int>: :const_iterator i = list.begin() ; 
while (i != list.endO) { 

do_something(*i) ; 

++i; 

} 
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Le code suivant est incorrect : 
// INEXACT 

QList<int>: :const_iterator i = splitter->sizes( ) .begin() ; 
while (i != splitter->sizes() .end() ) { 

do_something(*i) ; 

++i; 

} 

En effet, QSplitter : : sizes ( ) retourne un nouveau QList<int> par valeur a chacun de ses 
appels. Si nous ne stockons pas la valeur de retour, C++ la detruit automatiquement avant 
meme que nous ayons debute l'iteration, nous laissant avec un iterateur sans liaison. Pire 
encore, a chaque execution de la boucle, QSplitter: : sizes () doit generer une nouvelle 
copie de la liste a cause de l'appel splitter_>sizes ( ) . end ( ). 

En resume : lorsque vous utilisez des iterateurs de style STL, parcourez toujours vos elements 
sur une copie d'un conteneur. 

Avec les iterateurs de style Java en lecture seulement, il est inutile de recourir a une copie. 
L' iterateur se charge de creer cette copie en arriere-plan. Par exemple : 

QListIterator<int> i(splitter->sizes( ) ) ; 
while (i.hasNextf) ) { 

do_something ( i . next ( ) ) ; 

} 

La copie d'un conteneur tel que celui-ci semble couteuse, mais il n'en est rien, grace a l'opti- 
misation obtenue par le partage implicite. La copie d'un conteneur Qt est pratiquement aussi 
rapide que celle d'un pointeur unique. Les donnees ne sont veritablement copiees que si l'une 
des copies est changee - et tout ceci est gere automatiquement a 1' arriere-plan. C'est pourquoi 
le partage implicite est quelquefois nomme "copie a l'ecriture". 

L'interet du partage implicite est qu'il s'agit d'une optimisation dont nous beneficions sans 
intervention de la part du programmeur. En outre, le partage implicite favorise un style de 
programmation clair, ou les objets sont retournes par valeur. Considerez la fonction suivante : 

QVector<double> sineTable() 
{ 

QVector<double> vect(360); 
for (int i = 0; i < 360; ++i) 

vect[i] = sin(i / (2 * M_PI)); 
return vect; 

} 

Voici l'appel a la fonction : 

QVector<double> table = sineTable(); 

STL, nous incite plutot a transmettre le vecteur comme reference non const pour eviter 
1' execution de la copie lorsque la valeur de retour de la fonction est stockee dans une variable : 
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using namespace std; 

void sineTable(vector<double> &vect) 
{ 

vect.resize(360) ; 

for (int i = 0; i < 360; ++i) 

vect[i] = sin(i / (2 * M_PI)); 

} 

L' appel devient alors plus difficile a ecrire et a lire : 

vector<double> table; 
sineTable(table) ; 

Qt utilise le partage implicite pour tous ses conteneurs ainsi que pour de nombreuses autres 
classes, dont QByteArray, QBrush, QFont, Qlmage, QPixmap et QString . 

Le partage implicite est une garantie de la part de Qt que les donnees ne seront pas copiees si 
nous ne les modifions pas. Pour obtenir le meilleur du partage implicite, nous pouvons adopter 
deux nouvelles habitudes de progr animation. L'une consiste a coder la fonction at ( ) au lieu 
de l'operateur [ ] pour un acces en lecture seulement sur une liste ou un vecteur (non const). 
Les conteneurs Qt ne pouvant pas determiner si [ ] apparait sur le cote gauche d'une affecta- 
tion ou non, le pire est envisage et une copie integrate est declenchee - alors que at ( ) n'est 
pas autorise sur le cote gauche d'une affectation. 

Un probleme similaire se pose lorsque nous parcourons un conteneur avec des iterateurs de 
style STL. Des que nous appelons begin ( ) ou end ( ) sur un conteneur non const, Qt force une 
copie complete si les donnees sont partagees. Pour eviter ceci, la solution consiste a utiliser 
const_iterator, constBegin ( ) et constEnd ( ) des que possible. 

Qt fournit une derniere methode pour parcourir les elements situes dans un conteneur sequentiel : 
la boucle f oreach. Voici sa syntaxe : 

QLinkedList<Movie> list; 

foreach (Movie movie, list) { 

if (movie. title() == "Citizen Kane") { 
cout « "Found Citizen Kane" « endl; 
break; 

} 

} 

Le pseudo mot-cle foreach est implements sous la forme d'une boucle for standard. A 
chaque iteration de la boucle, la variable d'iteration (movie) est definie en un nouvel element, 
commencant au premier element du conteneur et progressant vers l'avant. La boucle foreach 
recoit automatiquement une copie du conteneur. Elle ne sera done pas affectee si le conteneur 
est modifie durant 1' iteration. 
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Fonctionnement du partage implicite 

Le partage implicite s'effectue automatiquement en arriere-plan. Aucune action n'est done 
necessaire dans notre code pour que cette optimisation se produise. Mais comme il est interes- 
sant de comprendre comment les choses fonctionnent, nous allons etudier un exemple et voir 
ce qui se passe en interne. L' exemple utilise QString, une des nombreuses classes implicitement 
partagees de Qt. 

QString stn = "Humpty"; 
QString str2 = stn ; 

Nous definissons stn en "Humpty" et str2 de sorte qu'il soit egal a strl. A ce stade, 
les deux objets QString pointent vers la meme structure de donnees interne en memoire. Avec les 
donnees de type caractere, il existe pour une structure de donnees un compteur de reference 
indiquant le nombre de QString pointant vers celle-ci. stn et str2 pointant vers la meme 
donnee, le compteur de reference indique 2. 

str2[0] = ' D ' ; 

Lorsque nous modifions str2, il realise tout d'abord une copie integrale des donnees pour 
s'assurer que strl et str2 pointent vers des structures de donnees differentes, puis il applique 
la modification a sa propre copie des donnees. Le compteur de reference des donnees de stn 
("Humpty") indique alors 1 et celui des donnees de str2 ("Dumpty") est defini en 1. Quand un 
compteur de reference indique 1, les donnees ne sont pas partagees. 

str2.truncate(4) ; 

Si nous modifions de nouveau str2, aucune copie ne se produit car le compteur de reference 
des donnees de str2 indique 1. La fonction truncate() agit directement sur les donnees de 
str2, resultant en la chame "Dump". Le compteur de reference reste a 1. 

stn = str2; 

Lorsque nous affectons str2 a strl, le compteur de reference des donnees de stn descend a 
0, ce qui signifie qu'aucun QString n'utilise plus la donnee "Humpty". La donnee est alors libe- 
ree de la memoire. Les deux QString pointent vers "Dump", dont le compteur de reference 
indique maintenant 2. 

Le partage de donnees est une option souvent ignoree dans les programmes multithread, a 
cause des conditions de competition dans le decompte des references. Avec Qt, ceci n'est plus 
un probleme. En interne, les classes conteneur utilisent des instructions du langage d'assembly 
pour effectuer un decompte de references atomique. Cette technologie est a la portee des 
utilisateurs de Qt par le biais des classes QSharedData et QSharedDataPointer. 
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Les instructions de boucle break et continue sont prises en charge. Si le corps est constitute 
d'une seule instruction, les accolades ne sont pas necessaires. Comme pour une instruction 
for, la variable d' iteration peut etre definie a l'exterieur de la boucle, comme suit : 

QLinkedList<Movie> list; 
Movie movie; 

foreach (movie, list) { 

if (movie. title() == "Citizen Kane") { 
cout « "Found Citizen Kane" « endl; 
break; 

} 

} 

La definition de la variable d'iteration a l'exterieur de la boucle est la seule solution pour les conte- 
neurs comportant des types de donnees avec une virgule (par exemple, QPair<QString , int>). 



Conteneurs associatifs 



Un conteneur associatif comporte un nombre arbitraire d'elements du meme type, indexes par 
une cle. Qt fournit deux classes de conteneurs associatifs principales : QMap<K,T> et 
QHash<K, T>. 

Un QMap<K,T> est une structure de donnees qui stocke des paires cle/valeur dans un ordre 
croissant des cles. Cette organisation permet d'obtenir de bonnes performances en matiere de 
recherche et d'insertion ainsi qu'une iteration ordonnee. En interne, QMap<K,T> est imple- 
mente sous forme de liste a branchement. (Voir Figure 1 1 .6) 
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Un moyen simple d'inserer des elements dans un map consiste a appeler insert ( ) : 

QMap<QString, int> map; 
map.insert( "eins" , 1); 
map. insert( "sieben" , 7); 
map.insertj "dreiundzwanzig" , 23) ; 

Nous avons aussi la possibilite d'affecter simplement une valeur a une cle donnee comme suit : 

map [ "eins" ] = 1 ; 

map[ "sieben" ] = 7; 

map[ "dreiundzwanzig" ] = 23; 
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L operateur [ ] peut etre utilise a la fois pour 1' insertion et la recuperation. Si [ ] est utilise pour 
recuperer une valeur d'une cle non existante dans un map non const, un nouvel element sera 
cree avec la cle donnee et une valeur vide. L'utilisation de la fonction value ( ) a la place de [ ] 
pour recuperer les elements permet d'eviter la creation accidentelle de valeurs vides : 

int val = map. value) "dreiundzwanzig" ) ; 

Si la cle n'existe pas, une valeur par defaut est retournee et aucun nouvel element n'est cree. 
Pour les types de base et les types pointeur, la valeur retournee est nulle. Nous pouvons specifier 
une autre valeur par defaut comme second argument pour value ( ) : 

int int seconds = map. value( "delay" , 30); 

Cette ligne de code est equivalente a : 

int seconds = 30; 

if (map. contains) "delay" ) ) 

seconds = map. value( "delay" ) ; 

Les types de donnees K et T d'un QMap<K,T> peuvent etre des types de base tels que int et 
double, des types pointeur ou de classes possedant un constructeur par defaut, un constructeur 
de copie et un operateur d' affectation. En outre, le type K doit fournir un operators ( ) car 
QMap<K, T> utilise cet operateur pour stacker les elements dans un ordre de cle croissant. 

QMap<K, T> possede deux fonctions utilitaires keys ( ) et values ( ) , qui s'averent particuliere- 
ment interessantes pour travailler avec de petits ensembles de donnees. Elles retournent des 
QList des cles et valeurs d'un map. 

Les maps sont generalement a valeur unique : si une nouvelle valeur est affectee a une cle exis- 
tante, l'ancienne valeur est remplacee par la nouvelle. De cette facon, deux elements ne parta- 
gent pas la meme cle. II est possible d' avoir des valeurs multiples pour la meme cle en utilisant 
la fonction insertMulti( ) ou la sous-classe utilitaire QMultiMap<K,T>. QMap<K,T> 
possede une surcharge values (constK &) qui retourne un QList de toutes les valeurs pour 
une cle donnee. Par exemple : 

QMultiMap<int, QString> multiMap; 
multiMap. insert(1 , "one"); 
multiMap. insert(1 , "eins"); 
multiMap. insert(1 , "uno"); 

QList<QString> vals = multiMap. values(1 ) ; 

Un QHash<K, T> est une structure de donnees qui stocke des paires cle/valeur dans une table de 
hachage. Son interface est pratiquement identique a celle de QMap<K,T>, mais ses exigences 
concernant le type template K sont differentes et il offre des operations de recherche beaucoup 
plus rapides que QMap<K, T>. Une autre difference est que QHash<K, T> n'est pas ordonne. 

En complement des conditions standard concernant tout type de valeur stocke dans un 
conteneur, le type K d'un QHash<K, T> doit fournir un operator== ( ) et etre supporte par une 
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fonction QHash ( ) globale qui retourne une valeur de hachage pour une cle. Qt fournit deja 
des fonctions QHash ( ) pour les types entiers, les types pointeur, QChar, QSt ring et QByteAr ray. 

QHash<K,T> alloue automatiquement un nombre principal de blocs pour sa table de hachage 
interne et redimensionne celle-ci lors de l'insertion ou de la suppression d'elements. II est 
egalement possible de regler avec precision les performances en appelant reserve () pour 
specifier le nombre d'elements a stacker dans la table etsqueeze() pour reduire cette table en 
fonction du nombre d'elements en cours. Une pratique courante consiste a appeler reserve ( ) 
avec le nombre maximum d'elements susceptibles d'etre stockes, puis a inserer les donnees et 
finalement a appeler squeeze ( ) pour reduire l'utilisation de la memoire si les elements sont 
moins nombreux que prevu. 

Les hachages sont generalement a valeur unique, mais plusieurs valeurs peuvent etre affectees 
a la meme cle a l'aide de la fonction insertMulti ( ) ou de la sous-classe utilitaire QMulti- 
hash<K,T>. 

En plus de QHash<K, T>, Qt fournit une classe QCache<K,T> qui peut etre utilisee pour placer 
en cache des objets associes a une cle, et un conteneur QSet<K> qui ne stocke que des cles. En 
interne, tous deux reposent sur QHash<K, T> et presentent les memes exigences concernant le 
type K. 

Le moyen le plus simple de parcourir toutes les paires cle/valeur stockees dans un conteneur 
associatif consiste a utiliser un iterateur de style Java. Les iterateurs de ce style utilises pour les 
conteneurs associatifs ne fonctionnent pas tout a fait de la meme facon que leurs homologues 
sequentiels. La principale difference est la suivante : les fonctions next() et previous () 
retournent un objet qui represente une paire cle/valeur, et non simplement une valeur. Les compo- 
sants cle et valeur sont accessibles depuis cet objet en tant que key ( ) et value ( ) . Par exemple : 

QMap<QString, int> map; 
int sum = 0; 

QMapIterator<QString, int> i(map); 
while (i.hasNext() ) 

sum += i.next( ) . value( ) ; 

Si nous devons acceder a la fois a la cle et a la valeur, nous pouvons simplement ignorer la 
valeur de retour de next ( ) ou de previous ( ) et executer les fonctions key ( ) et value ( ) de 
1' iterateur, qui operent sur le dernier element franchi : 

QMapIterator<QString, int> i(map); 
while (i.hasNext() ) { 
i.next() ; 

if (i.value() > largestValue) { 
largestKey = i.key() ; 
largestValue = i.value(); 

} 

} 
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Les iterateurs mutables possedent une fonction setValue( ) qui modifie la valeur associee a 
un element courant : 

QMutableMapIterator<QString, int> i(map); 
while (i.hasNext() ) { 
i.next() ; 

if (i.value() < 0.0) 

i.setValue(-i. value() ) ; 

} 

Les iterateurs de style STL fournissent egalement des fonctions key ( ) et value ( ). Avec des 
types d' iterateur non const, value ( ) retourne une reference non const, ce qui nous permet 
de changer la valeur au cours de l'iteration. Remarquez que, bien que ces iterateurs soient "de 
style STL", ils presentent des differences significatives avec les iterateurs map<K,T> de STL, 
qui sont bases sur pair<K, T>. 

La boucle f oreach fonctionne egalement avec les conteneurs associatifs, mais uniquement 
avec le composant valeur des paires cle/valeur. Si nous avons besoin des deux composants cle 
et valeur des elements, nous pouvons appeler les fonctions keys() et values (constK &) 
dans des boucles f oreach imbriquees comme suit : 

QMultiMap<QString, int> map; 

foreach (QString key, map.keys()) { 

foreach (int value, map. values(key) ) { 
do_something(key, value); 

} 

} 

Algorithmes generiques 

Len-tete <QtAlgorithms> declare un ensemble de fonctions template globales qui imple- 
mentent des algorithmes de base sur les conteneurs. La plupart de ces fonctions agissent sur 
des iterateurs de style STL. 

L'en-tete STL <algorithm> fournit un ensemble d'algorithmes generiques plus complet. Ces 
algorithmes peuvent etre employes avec des conteneurs Qt ainsi que des conteneurs STL. Si 
les implementations STL sont disponibles sur toutes vos plates-formes, il n'y a probablement 
aucune raison de ne pas utiliser les algorithmes STL lorsque Qt ne propose pas l'algorithme 
equivalent. Nous presenterons ici les algorithmes Qt les plus importants. 

L'algorithme qFind() recher286che une valeur particuliere dans un conteneur. II recoit un 
iterateur "begin" et un iterateur "end" et retourne un iterateur pointant sur le premier element 
correspondant, ou "end" s'il n'existe pas de correspondance. Dans l'exemple suivant, i est 
defini en list . begin ( ) + 1 alors que j est defini en list . end ( ) . 

QStringList list; 
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list « "Emma" « "Karl" « "James" « "Mariette"; 

QStringList: : iterator i = qFind(list.begin() , list.end(), "Karl"); 
QStringList: : iterator j = qFind(list.begin() , list.end(), "Petra"); 

L'algorithme qBinaryFind() effectue une recherche similaire a qFind(), mais il suppose 
que les elements sont tries dans un ordre croissant et utilise la recherche binaire rapide au lieu 
de la recherche lineaire de qFind ( ) . 

L'algorithme qFill ( ) remplit un conteneur avec une valeur particuliere : 

QLinkedList<int> list(10); 
qFill(list.begin() , list.endf), 1009); 

Comme les autres algorithmes bases sur les iterateurs, nous pouvons egalement utiliser 
qFill ( ) sur une partie du conteneur en variant les arguments. L'extrait de code suivant initia- 
lise les cinq premiers elements d'un vecteur en 1009 et les cinq derniers elements en 2013 : 

QVector<int> vect(10) ; 

qFill(vect.begin() , vect.begin() + 5, 1009); 
qFill(vect.end() - 5, vect.end(), 2013); 

L'algorithme qCopy ( ) copie des valeurs d'un conteneur a un autre : 

QVector<int> vect(list.count( ) ) ; 

qCopyflist . begin( ) , list.end(), vect.begin()) ; 

qCopy ( ) peut egalement etre utilise pour copier des valeurs dans le meme conteneur, ceci tant 
que la plage source et la plage cible ne se chevauchent pas. Dans l'extrait de code suivant, nous 
l'utilisons pour remplacer les deux derniers elements d'une liste par les deux premiers : 

qCopy(list . begin( ) , list.begin() + 2, list.end() - 2); 

L'algorithme qSort ( ) trie les elements du conteneur en ordre croissant : 
qSort(list.begin() , list.end()); 

Par defaut, qSort() se sert de l'operateur < pour comparer les elements. Pour trier les 
elements en ordre decroissant, transmettez qGreater<T>( ) comme troisieme argument (ou T 
est le type des valeurs du conteneur), comme suit : 

qSort(list.begin() , list.end(), qGreater<int>( ) ) ; 

Nous pouvons utiliser le troisieme parametre pour definir un critere de tri personnalise. Voici, 
par exemple, une fonction de comparaison "inferieur a" qui compare des QString sans prendre la 
casse (majuscule -minuscule) en consideration : 

bool insensitiveLessThan (const QString &str1, const QString &str2) 
{ 

return strl .toLowerf ) < str2.toLower() ; 
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} 

L'appel a qSort ( ) devient alors : 
QStringList list; 

qSort (list. begin () , list.end(), insensitiveLessThan) ; 

L' algorithme qStableSort ( ) est similaire a qSort(), si ce n'est qu'il garantit que les 
elements egaux apparaissent dans le meme ordre avant et apres le tri. Cette caracteristique est 
utile si le critere de tri ne prend en compte que des parties de la valeur et si les resultats sont 
visibles pour l'utilisateur. Nous avons utilise qStableSort ( ) dans le Chapitre 4 pour imple- 
menter le tri dans 1' application Spreadsheet. 

L' algorithme qDeleteAll() appelle delete sur chaque pointeur stocke dans un conteneur. 
Ceci n'est utile que pour les conteneurs dont le type de valeur est un type pointeur. Apres l'appel, 
les elements sont toujours presents, vous executez clear ( ) sur le conteneur. Par exemple : 

qDeleteAll(list) ; 
list.clear() ; 

L' algorithme qSwap ( ) echange la valeur de deux variables. Par exemple : 

int x1 = line.xl ( ) ; 
int x2 = line.x2() ; 
if (x1 > x2) 

qSwap(x1, x2); 

Enfin, l'en-tete <QtGlobal> fournit plusieurs definitions utiles, dont la fonction qAbs ( ), qui 
retourne la valeur absolue de son argument ainsi que les fonctions qMin ( ) et qMax ( ) qui retournent 
le minimum ou le maximum entre deux valeurs. 



Chaines, tableaux d'octets et variants 

QString, QByteArray et QVariant sont trois classes ayant de nombreux points en commun 
avec les conteneurs. Elles sont susceptibles d'etre utilisees a la place de ceux-ci dans certaines 
situations. En outre, comme les conteneurs, ces classes utilisent le partage implicite pour 
optimiser la memoire et la vitesse. 

Nous allons commencer par QSt ring. Les chaines sont utilisees par tout programme GUI, non 
seulement pour 1' interface utilisateur, mais egalement en tant que structures de donnees. C++ 
fournit en natif deux types de chaines : les traditionnels tableaux de caracteres termines par "0" 
et la classe std: : string. Contrairement a celles-ci, QString contient des valeurs Unicode 
16 bits. Unicode comprend les systemes ASCII et Latin-1, avec leurs valeurs numeriques habi- 
tuelles. Mais QString etant une classe 16 bits, elle peut representer des milliers de caracteres 
differents utilises dans la plupart des langues mondiales. Reportez-vous au Chapitre 17 pour de 
plus amples informations concernant Unicode. 
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Lorsque vous utilisez QString, vous n'avez pas besoin de vous preoccuper de details comme 
1' allocation d'une memoire suffisante ou de verifier que la donnee est terminee par "0". 
Conceptuellement, les objets QString peuvent etre considered comme des vecteurs de QChar. 
Un QString peut integrer des caracteres "0". La fonction length () retourne la taille de la 
chaine entiere, dont les caracteres "0" integres. 

QString fournit un operateur + binaire destine a concatener deux chaines ainsi qu'un ope- 
rateur += dont la fonction est d'accoler une chaine a une autre. Voici un exemple combinant 
+ et +=. 

QString str = "User: " ; 
str += userName + "\n" ; 

II existe egalement une fonction QString : : append ( ) dont la tache est identique a celle de 
1' operateur += : 

str = "User: " ; 
str.append(userName) ; 
str .append( " \n" ) ; 

Un moyen totalement different de combiner des chaines consiste a utiliser la fonction 
sprintf( ) de QString : 

str.sprintf ("%s %.1f%%", "perfect competition" , 100.0); 

Cette fonction prend en charge les memes specificateurs de format que la fonction sprintf ( ) 
de la bibliotheque C++. Dans l'exemple ci-dessus, "perfect competition 100.0 %" est affecte 
a str. 

Un moyen supplemental de creer une chaine a partir d'autres chaines ou de nombres consiste 
a utiliser arg( ) : 

str = QString ("%1 %2 (%3s-%4s)") 

.arg(" permissive") .arg( "society" ) .arg(1950) .arg(1970) ; 

Dans cet exemple, "%1", "%2", "%3" et "%4" sont remplaces par "permissive", "society", 
"1950" et "1970", respectivement. On obtient "permissive society (1950s- 1970s)". II existe des 
surcharges de arg ( ) destinees a gerer divers types de donnees. Certaines surcharges compor- 
tent des parametres supplementaires afin de controler la largeur de champ, la base numerique 
ou la precision de la virgule flottante. En general, arg ( ) represente une solution bien meilleure 
que sprintf ( ), car elle est de type securise, prend totalement en charge Unicode et autorise 
les convertisseurs a reordonner les parametres "%n". 

QString peut convertir des nombres en chaines au moyen de la fonction statique QString: 
:number() : 

str = QString: :number(59. 6) ; 
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Ou en utilisant la fonction setNum ( ) : 
str.setNum(59.6) ; 

La conversion inverse, d'une chaine en un nombre, est realisee a l'aide de toInt(), 
toLongLong( ), toDouble( ) et ainsi de suite. Par exemple : 

bool ok; 

double d = str.toDouble(&ok) ; 

Ces fonctions peuvent recevoir en option un pointeur facultatif vers une variable bool et elles 
definissent la variable en true ou false selon le succes de la conversion. Si la conversion 
echoue, les fonctions retournent zero. 

II est souvent necessaire d'extraire des parties d'une chaine La fonction mid ( ) retourne la 
sous-chaine debutant a un emplacement donne (premier argument) et de longueur donnee 
(second argument). Par exemple, le code suivant affiche "pays" sur la console 1 : 

QString str = "polluter pays principle"; 
qDebug( ) « str.mid(9, 4) ; 

Si nous omettons le second argument, mid( ) retourne la sous-chaine debutant a l'emplace- 
ment donne et se terminant a la fin de la chaine. Par exemple, le code suivant affiche "pays 
principle" sur la console : 

QString str = "polluter pays principle"; 
qDebugf ) « str.mid(9) ; 

II existe aussi des fonctions left ( ) et right ( ) dont la tache est similaire. Toutes deux recoi- 
vent un nombre de caracteres, n, et retournent les n premiers ou derniers caracteres de la 
chaine. Par exemple, le code suivant affiche "polluter principle" sur la console : 

QString str = "polluter pays principle"; 
qDebugf) « str.left(8) « " " « str. right(9) ; 

Pour rechercher si un chaine contient un caractere particulier, une sous-chaine ou une expression 
reguliere, nous pouvons utiliser Tune des fonctions indexOf ( ) de QString : 

QString str = "the middle bit"; 
int i = str.indexOff "middle" ) ; 

Dans ce cas, i sera defini en 4. La fonction indexOf ( ) retourne 1 en cas d'echec et recoit en 
option un emplacement de depart ainsi qu'un indicateur de sensibilite a la casse. 



1. La syntaxe qDebugf )<<arg utilisee ici necessite 1'inclusion du fichier d'en-tete <QtDebug>, alors 
que la syntaxe qDebug ( " ... " , arg ) est disponible dans tout fichier incluant au moins un en-tete Qt. 
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Si nous souhaitons simplement verifier si une chaine commence ou se termine par quelque 
chose, nous pouvons utiliser les fonctions startsWith ( ) et endsWith ( ) : 

if (url. startsWith ("http: ") && u rl. endsWith (" .png" ) ) 

Ce qui est a la fois plus rapide et plus simple que : 

if (url.left(5) == "http:" && url.right(4) == ".png") 

La comparaison de chaines avec l'operateur == differencie les majuscules des minuscules. Si 
nous comparons des chaines visibles pour l'utilisateur, localeAwareCompare ( ) represente 
generalement un bon choix, et si nous souhaitons effectuer des comparaisons sensibles a la 
casse, nous pouvons utiliser toUpper ( ) ou toLower ( ) . Par exemple : 

if (fileName.toLower() == "readme.txt") 

Pour remplacer une certaine partie d'une chaine par une autre chaine, nous codons 
replace() : 

QString str = "a cloudy day"; 
str.replace(2, 6, "sunny"); 

On obtient "a sunny day". Le code peut etre reecrit de facon a executer remove ( ) et 
insert ( ). 

str. remove (2, 6); 
str.insert(2, "sunny"); 

Dans un premier temps, nous supprimons six caracteres en commencant a l' emplacement 2, ce 
qui aboutit a la chaine "a day" (avec deux espaces), puis nous inserons "sunny" a ce meme 
emplacement. 

Des versions surchargees de replace () permettent de remplacer toutes les occurrences de 
leur premier argument par leur second argument. Par exemple, voici comment remplacer toutes 
les occurrences de "&" par "&" dans une chaine : 

str . replacef "&" , "&"); 

II est tres souvent necessaire de supprimer les blancs (tels que les espaces, les tabulations et les 
retours a la lignes) dans une chaine. QString possede une fonction qui elimine les espaces 
situes aux deux extremites d'une chaine : 

QString str = " BOB \t THE \nD0G \n"; 
qDebugf) « str.t rimmed () ; 
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La chaine str peut etre representee comme suit : 
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La chaine retournee par t rimmed ( ) est 
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Lorsque nous gerons les entrees utilisateur, nous avons souvent besoin de remplacer les 
sequences internes d'un ou de plusieurs caracteres d'espace par un espace unique, ainsi que 
d'eliminer les espaces aux deux extremites. Voici Taction de la fonction simplified ( ) : 

QString str = 11 BOB \t THE \nD0G \n"; 
qDebugf) « str. simplified () ; 

La chaine retournee par simplified ( ) est : 
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Une chaine peut etre divisee en un QString List de sous-chaines au moyen de 
QString: : split () : 

QString str = "polluter pays principle"; 
QStringList words = str.split(" "); 

Dans l'exemple ci-dessus, nous divisons la chaine "polluter pays principle" en trois sous- 
chaines : "polluter", "pays" et "principle". La fonction split () possede un troisieme argu- 
ment facultatif qui specifie si les sous-chaines vides doivent etre conservees (option par defaut) 
ou eliminees. 

Les elements d'un QStringList peuvent etre unis pour former une chaine unique au moyen 
de j oin ( ) . L' argument de j oin ( ) est insere entre chaque paire de chaines jointes. Par exem- 
ple, voici comment creer une chaine unique qui est composee de toutes les chaines contenues 
dans un QStringList triees par ordre alphabetique et separees par des retours a la lignes : 

words. sort () ; 

str = words. join( " \n" ) ; 

En travaillant avec les chaines, il est souvent necessaire de determiner si elles sont vides ou 
non. Pour ce faire, appelez isEmpty ( ) ou verifiez si length ( ) est egal a 0. 

La conversion de chaines const char* en QString est automatique dans la plupart des cas. 
Par exemple : 



str += " (1870)"; 
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Ici nous ajoutons un constchar* a un QString sans formalite. Pour convertir explicitement 
un const char* en un QString, il suffit d'utiliser une conversion QString ou encore 
d'appeler f romAscii( ) ou f romLatinl ( ). (Reportez-vous au Chapitre 17 pour obtenir une 
explication concernant la gestion des chaines litterales et autres codages.) 

Pour convertir un QString en un const char *, executez toAscii( ) ou toLatinl ( ). Ces 
fonctions retournent un QByteArray, qui peut etre converti en un const char* en codant 
QByteArray : : data( ) ou QByteArray : : constData ( ). Par exemple : 

printf ( "User: %s\n", str.toAscii( ) .data() ) ; 

Pour des raisons pratiques, Qt fournit la macro qPrintable( ) dont Taction est identique a 
celle de la sequence toAscii ( ) . constData ( ) : 

printf ( "User: %s\n", qPrintable(str) ) ; 

Lorsque nous appelons data() ou constData() sur un QByteArray, la chaine retournee 
appartient a l'objet QByteArray, ce qui signifie que nous n'avons pas a nous preoccuper de 
problemes de pertes de memoire. Qt se chargera de liberer la memoire. D'autre part, nous 
devons veiller a ne pas utiliser le pointeur trop longtemps. Si le QByteArray n'est pas stocke 
dans une variable, il sera automatiquement supprime a la fin de l'instruction. 

La classe QByteArray possede une API tres similaire a celle de QString. Des fonctions telles 
que left ( ), right ( ), mid ( ), toLower ( ), toUpper ( ), trimmed ( ) et simplified ( ) ont la 
meme semantique dans QByteArray que leurs homologues QString. QByteArray est utile 
pour stacker des donnees binaires brutes et des chaines de texte codees en 8 bits. En general, 
nous conseillons d'utiliser QString plutat que QByteArray pour stacker du texte, car cette 
classe supporte Unicode. 

Pour des raisons de commodite, QByteArray s'assure automatiquement que l'octet suivant le 
dernier element est toujours "0", ce qui facilite la transmission d'un QByteArray a une fonction 
recevant un const char *. QByteArray prend aussi en charge les caracteres "0" integres, ce 
qui nous permet de l'utiliser pour stacker des donnees binaires arbitraires. 

Dans certaines situations, il est necessaire de stacker des donnees de types differents dans la 
meme variable. Une approche consiste a coder les donnees en tant que QByteArray ou 
QString. Ces approches offrent une flexibilite totale, mais annule certains avantages du C++, 
et notamment la securite et l'efficacite des types. Qt offre une bien meilleure solution pour 
gerer des variables contenant differents types : QVa riant. 

La classe QVariant peut contenir des valeurs de nombreux types Qt, dont QBrush, QColor, 
QCursor, QDateTime, QFont, QKeySequence, QPalette, QPen, QPixmap, QPoint, QRect, 
QRegion, QSize et QString, ainsi que des types numeriques C++ de base tels que double et 
int. Cette classe est egalement susceptible de contenir des conteneurs : QMap<QString , 
QVariant>, QStringList et QList<QVariant>. 
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Les variants sont abondamment utilises par les classes d'affichage d'elements, le module de 
base de donnees et QSettings, ce qui nous permet de lire et d'ecrire des donnees d'element, 
des donnees de base de donnees et des preferences utilisateur pour tout type compatible 
QVariant. Nous en avons deja rencontre un exemple dans le Chapitre 3, oil nous avons trans- 
mis un QRect, un QStringList et deux bool en tant que variants a QSettings : : setValue ( ). 
Nous les avons recuperes ulterieurement comme variants. 

II est possible de creer arbitrairement des structures de donnees complexes utilisant QVariant 
en imbriquant des valeurs de types conteneur : 

QMap<QString, QVariant> pearMap; 
pearMap[ "Standard" ] = 1.95; 
pearMap[ "Organic" ] = 2.25; 

QMap<QString, QVariant> fruitMap; 
fruitMap[ "Orange" ] = 2.10; 
fruitMap[ "Pineapple" ] = 3.85; 
f ruitMap[ "Pear" ] = pearMap; 

Ici, nous avons cree un map avec des cles sous forme de chaines (noms de produit) et des 
valeurs qui sont soit des nombres a virgule flottante (prix), soit des maps. Le map de niveau 
superieur contient trois cles : "Orange", "Pear" et "Pineapple". La valeur associee a la cle 
"Pear" est un map qui contient deux cles ("Standard" et "Organic"). Lorsque nous parcourons 
un map contenant des variants, nous devons utiliser type ( ) pour en controler le type de facon 
a pouvoir repondre de facon appropriee. 

La creation de telles structures de donnees peut sembler tres seduisante, car nous pouvons ainsi 
organiser les donnees exactement comme nous le souhaitons. Mais le caractere pratique de 
QVariant est obtenu au detriment de l'efficacite et de la lisibilite. En regie generale, il 
convient de definir une classe C++ correcte pour stacker les donnees des que possible. 

QVariant est utilise par le systeme metaobjet de Qt et fait done partie du module QtCore. 
Neanmoins, lorsque nous le rattachons au module QtGui, QVariant peut stacker des types 
en liaison avec l'interface utilisateur graphique tels que QColor, QFont, Qlcon, Qlmage et 
QPixmap : 

Qlcon icon( "open.png" ) ; 
QVariant variant = icon; 

Pour recuperer la valeur d'un tel type a partir d'un QVariant, nous pouvons utiliser la fonction 
membre template QVariant : :Value<T>( ) comme suit : 

Qlcon icon = variant. value<QIcon>() ; 

La fonction value<T>() permet egalement d'effectuer des conversions entre des types de 
donnees non graphiques et QVariant, mais en pratique, nous utilisons habituellement les 
fonctions de conversion to...( ) (par exemple, toString ( )) pour les types non graphiques. 
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QVariant peut aussi etre utilise pour stacker des types de donnees personnalises, en 
supposant qu'ils fournissent un constructeur par defaut et un constructeur de copie. Pour 
que ceci fonctionne, nous devons tout d'abord enregistrer le type au moyen de la macro 
Q_DECLARE_METATYPE ( ), generalement dans un fichier d'en-tete en dessous de la definition 
de classe : 

Q_DECLARE_METATYPE(BusinessCard) 

Cette technique nous permet d'ecrire du code tel que celui-ci : 
BusinessCard businessCard; 

QVariant variant = QVariant: :f romValue(businessCard) ; 

if (variant .canConvert<BusinessCard>( ) ) { 

BusinessCard card = variant . value<BusinessCard>( ) ; 

} 

Ces fonctions membre template ne sont pas disponibles pour MSVC 6, a cause d'une limite du 
compilateur. Si vous devez employer ce compilateur, utilisez plutat les fonctions globales 
qVariantFromValue ( ), qVariantValue<T> ( )et qVariantCanConvert<T> ( ). 

Si le type de donnees personnalise possede des operateurs « et » pour effectuer des operations 
de lecture et d'ecriture dans un QDataStream, nous pouvons les enregistrer au moyen de 
qRegisterMetaTypeStreamOperators<T>( ). II est ainsi possible de stacker les preferences 
des types de donnees personnalises a l'aide de QSettings, entre autres. Par exemple : 

qRegisterMetaTypeStreamOperators<BusinessCard>( "BusinessCard" ) ; 

Dans ce chapitre, nous avons principalement etudie les conteneurs Qt, ainsi que QString, 
QByteArray et QVariant. En complement de ces classes, Qt fournit quelques autres conte- 
neurs. QPair<T1 , T2> en fait partie, qui stocke simplement deux valeurs et presente des simili- 
tudes avec std : : pair<T1 , T2>. QBitArray est un autre conteneur que nous utiliserons dans 
la premiere partie du Chapitre 19. II existe enfin QVarLengthArray<T, Prealloc>, une alter- 
native de bas niveau a QVector<T>. Comme il prealloue de la memoire sur la pile et n'est pas 
implicitement partage, sa surcharge est inferieure a celle de QVector<T>, ce qui le rend plus 
approprie pour les boucles etroites. 

Les algorithmes de Qt, dont quelques-uns n'ayant pas ete etudies ici tels que qCopyBackward ( ) 
et qEqual( ), sont decrits dans la documentation de Qt a l'adresse http://doc.trolltech.com/ 
4.1/algorithms.html. Vous trouverez des details complementaires concernant les conteneurs 
de Qt a l'adresse http://doc.trolltech.eom/4.l/containers.html. 
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Au sommaire de ce chapitre 

\/ Lire et ecrire des donnees binaires 

^ Lire et ecrire du texte 

^ Parcourir des repertoires 

i/ Integrer des ressources 

^ Communication inter-processus 



Le besoin d'effectuer des operations de lecture et d'ecriture dans des fichiers ou sur un 
autre support est commun a presque toute application. Qt fournit un excellent support 
pour ces operations par le biais de QIODevice, une abstraction puissante qui encapsule 
des "peripheriques" capables de lire et d'ecrire des blocs d'octets. Qt inclut les sous- 
classes QIODevice suivantes : 



QFile 


Accede aux fichiers d'un systeme de fichiers local et de ressources integrees. 


QTemporaryFile 


Cree et accede a des fichiers temporaires du systeme de fichiers local. 


QBuffer 


Effectue des operations de lecture et d'ecriture de donnees dans un QByteArray. 


QProcess 


Execute des programmes externes et gere la communication inter-processus. 


QTcpSocket 


Transfere un flux de donnees sur le reseau au moyen de TCP. 


QUdpSocket 


Envoie ou recoit des datagrammes UDP sur le reseau. 
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(Process, QTcpSocket et QUdpSocket sont des classes sequentielles, ce qui implique un 
acces unique aux donnees, en commencant par le premier octet et en progressant dans l'ordre 
jusqu'au dernier octet. QFile, QTemporaryFile et QBuf f er sont des classes a acces aleatoire. 
Les octets peuvent done etre lus plusieurs fois a partir de tout emplacement. Elles fournissent 
la fonction QIODevice : : seek ( ) qui permet de repositionner le pointeur de fichier. 

En plus de ces classes de peripherique, Qt fournit deux classes de flux de niveau plus eleve qui 
executent des operations de lecture et ecriture sur tout peripherique d'E/S : QDataStream pour 
les donnees binaires et QTextStream pour le texte. Ces classes gerent des problemes tels que 
le classement des octets et les codages de texte, de sorte que des applications Qt s' executant 
sur d'autres plates-formes ou pays puissent effectuer des operations de lecture et d'ecriture sur 
leurs fichiers respectifs. Ceci rend les classes d'E/S de Qt beaucoup plus pratiques que les classes 
C++ standard correspondantes, qui laissent la gestion de ces problemes au programmeur de 
P application. 

QFile facilite P acces aux fichiers individuels, qu'ils soient dans le systeme de fichier ou inte- 
gres dans P executable de Papplication en tant que ressources. Pour les applications ayant 
besoin d'identifier des jeux complets de fichiers sur lesquels travailler, Qt fournit les classes 
QDir et QFilelnfo, qui gerent des repertoires et fournissent des informations concernant 
leurs fichiers. 

La classe QProcess nous permet de lancer des programmes externes et de communiquer avec 
ceux-ci par le biais de leurs canaux d'entree, de sortie et d'erreur standard (cin, cout et 
cerr). Nous pouvons definir les variables d'environnement et le repertoire de travail qui seront 
utilises par Papplication externe. Par defaut, la communication avec le processus est asyn- 
chrone (non bloquante), mais il est possible de parvenir a un blocage pour certaines operations. 

La gestion de reseau ainsi que la lecture et Pecriture XML sont des themes importants qui 
seront traites separement dans leurs propres chapitres (Chapitre 14 et Chapitre 15). 

Lire et ecrire des donnees binaires 

La facon la plus simple de charger et d'enregistrer des donnees binaires avec Qt consiste a 
instancier un QFile, a ouvrir le fichier et a y acceder par le biais d'un objet QDataStream. Ce 
dernier fournit un format de stockage independant de la plate-forme qui supporte les types C++ 
de base tels que int et double, de nombreux types de donnees Qt, dont QByteArray, QFont, 
Qlmage, QPixmap, QString et QVariant ainsi que des classes conteneur telles que QList<T> 
et QMap<K,T>. 

Voici comment stacker un entier, un Qlmage et un QMap<QString , QColor> dans un fichier 
nommefacts.dat : 

Qlmage image( "philip.png" ) ; 

QMap<QString, QColor> map; 
map. insert ( "red" , Qt::red); 
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map. insert ( "green" , Qt: : green) ; 
map. insert( "blue" , Qt::blue); 

QFile file("facts.dat"); 

if ( !file.open(QIODevice: :WriteOnly) ) { 

cerr « "Cannot open file for writing: " 

« qPrintable(file.errorString( ) ) « endl; 

return; 

} 

QDataStream out(&file); 
out.setVersion(QDataStream: :Qt_4_1 ) ; 

out « quint32(0x12345678) « image « map; 

Si nous ne pouvons pas ouvrir le fichier, nous en informons l'utilisateur et rendons le controle. 
La macro qPrintable() retoume un constchar* pour un QString. (Une autre approche 
consiste a executer QString: : toStdString ( ), qui retourne un std: : string, pour lequel 
<iostream> possede une surcharge «.) 

Si le fichier s'ouvre avec succes, nous creons un qDataStream et definissons son numero de 
version. Le numero de version est un entier qui influence la facon dont les types de donnees Qt 
sont represented (les types de donnees C++ de base sont toujours represented de la meme 
facon). Dans Qt 4.1, le format le plus complet est la version 7. Nous pouvons soit coder en dur 
la constante 7, soit utiliser le nom symbolique QDataSt ream : : Qt_4_1 . 

Pour garantir que le nombre 0x12345678 sera bien enregistre en tant qu' entier non signe de 
32 bits sur toutes les plates-formes, nous le convertissons en quint32, un type de donnees 
dont les 32 bits sont garantis. Pour assurer l'interoperabilite, QDataStream est base par defaut 
sur Big-Endian, ce qui peut etre modifie en appelant setByteOrder ( ) . 

II est inutile de fermer explicitement le fichier, cette operation etant effectuee automatiquement 
lorsque la variable QFile sort de la portee. Si nous souhaitons verifier que les donnees ont bien 
ete ecrites, nous appelons flush ( ) et verifions sa valeur de retour (true en cas de succes). 

Le code destine a lire les donnees reflete celui que nous avons utilise pour les ecrire : 

quint32 n; 
Qlmage image; 

QMap<QString, QColor> map; 

QFile file("facts.dat"); 

if ( !file.open(QIODevice: :ReadOnly) ) { 

cerr « "Cannot open file for reading: " 

« qPrintable(file.errorString( ) ) « endl; 

return; 

} 

QDataStream in(&f ile) ; 

in. setVersion (QDataStream: :Qt_4_1 ) ; 



in » n » image » map; 
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La version de QDataStream que nous employons pour la lecture est la meme que celle utilisee 
pour l'ecriture, ce qui doit toujours etre le cas. En codant en dur le numero de version, nous 
garantissons que 1' application est toujours en mesure de lire et d'ecrire les donnees. 

QDataStream stocke les donnees de telle facon que nous puissions les lire parfaitement. Par 
exemple, un QByteArray est represents sous la forme d'un decompte d'octets, suivi des octets 
eux-memes. QDataStream peut aussi etre utilise pour lire et ecrire des octets bruts, sans en- 
tete de decompte d'octets, au moyen de readRawBytes ( ) et de writeRawBytes ( ). 

Lors de la lecture a partir d'un QDataStream, la gestion des erreurs est assez facile. Le flux 
possede une valeur status () qui peut etre QDataStream: :0k, QDataStream: :Read- 
PastEnd ou QDataStream : : ReadCorruptData. Quand une erreur se produit, l'operateur » 
lit toujours zero ou des valeurs vides. Nous pouvons ainsi lire un fichier entier sans nous preoc- 
cuper d' erreurs potentielles et verifier la valeur de status ( ) a la fin pour determiner si ce que 
nous avons lu etait valide. 

QDataStream gere plusieurs types de donnees C++ et Qt. La liste complete est disponible a 
l'adresse http://doc.trolltech.eom/4.l/datastreamformat.html. Nous pouvons egalement 
ajouter la prise en charge de nos propres types personnalises en surchargeant les operateurs 
« et >>. Voici la definition d'un type de donnees personnalise susceptible d'etre utilise avec 
QDataStream : 

class Painting 
{ 

public: 

Painting () { myYear = 0; } 

Paintingjconst QString &title, const QString &artist, int year) { 
myTitle = title; 
myArtist = artist; 
myYear = year; 

} 

void setTitle(const QString &title) { myTitle = title; } 
QString titlej) const { return myTitle; } 

private: 

QString myTitle; 
QString myArtist; 
int myYear; 

}; 

QDataStream &operator«(QDataStream &out, const Painting &painting); 

QDataStream &operator»(QDataStream &in, Painting &painting); 

Voici comment nous implementerions l'operateur « : 

QDataStream &operator«(QDataStream &out, const Painting &painting) 

{ 

out « painting. title ( ) « painting. artist () 

« quint32(painting.year( ) ) ; 
return out; 

} 
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Pour emettre en sortie un Painting, nous emettons simplement deux QString et un 
quint 32. A la fin de la fonction, nous retournons le flux. C'est une expression C++ courante 
qui nous permet d'utiliser une chaine d' operate urs « avec un flux de sortie. Par exemple : 

out « paintingl « painting2 « painting3; 

L' implementation de operator»( ) est similaire a celle de operator<< ( ) : 

QDataStream &operator»(QDataStream &in, Painting &painting) 
{ 

QString title; 
QString artist; 
quint32 year; 

in » title » artist » year; 

painting = Painting(title, artist, year); 

return in; 

} 

II existe plusieurs avantages a fournir des operateurs de flux pour les types de donnees person- 
nalises. L'un d'eux est que nous pouvons ainsi transmettre des conteneurs qui utilisent le type 
personnalise. Par exemple : 

QList<Painting> paintings = . . . ; 
out « paintings; 

Nous pouvons lire les conteneurs tout aussi facilement : 

QList<Painting> paintings; 
in » paintings; 

Ceci provoquerait une erreur de compilateur si Painting ne supportait pas « ou ». Un autre 
avantage des operateurs de flux pour les types personnalises est que nous pouvons stocker 
les valeurs de ces types en tant que QVariant, ce qui les rend plus largement utilisables, 
par exemple par les QSetting. Ceci ne fonctionne que si nous enregistrons prealablement 
le type en executant qRegisterMetaTypeStreamOperators<T> ( ), comme explique dans le 
Chapitre 11. 

Lorsque nous utilisons QDataStream, Qt se charge de lire et d'ecrire chaque type, dont les 
conteneurs avec un nombre arbitraire d'elements. Cette caracteristique nous evite de structurer 
ce que nous ecrivons et d'appliquer une conversion a ce que nous lisons. Notre seule obligation 
consiste a nous assurer que nous lisons tous les types dans leur ordre d'ecriture, en laissant a 
Qt le soin de gerer tous les details. 

QDataStream est utile a la fois pour nos formats de fichiers d' application personnalises et 
pour les formats binaires standard. Nous pouvons lire et ecrire des formats binaires standard en 
utilisant les operateurs de flux sur les types de base (tels que quintl 6 ou float) ou au moyen 
de readRawBytes ( ) et de writeRawBytes ( ). Si le QDataStream est purement utilise pour 
lire et ecrire des types de donnees C++ de base, il est inutile d'appeler setVersion(). 
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Jusqu'a present, nous avons charge et enregistre les donnees avec la version codee en dur du 
flux sous la forme QDataStream : :Qt_4_1. Cette approche est simple et sure, mais elle 
presente un leger inconvenient : nous ne pouvons pas tirer parti des formats nouveaux ou mis a 
jour. Par exemple, si une version ulterieure de Qt ajoutait un nouvel attribut a QFont (en plus 
de sa famille, de sa taille, etc.) et que nous ayons code en dur le numero de version en Qt_4_1 , 
cet attribut ne serait pas enregistre ou charge. Deux solutions s'offrent a vous. La premiere 
approche consiste a integrer le numero de version QDataStream dans le fichier : 

QDataStream out(&file); 

out « quint32(MagicNumber) « quint16(out . version() ) ; 

(MagicNumber est une constante qui identifie de facon unique le type de fichier.) Avec cette 
approche, nous ecrivons toujours les donnees en utilisant la version la plus recente de QData- 
Stream. Lorsque nous en venons a lire le fichier, nous lisons la version du flux : 

quint32 magic; 
quint16 streamVersion; 

QDataStream in(&f ile) ; 

in » magic » streamVersion; 

if (magic != MagicNumber) { 

cerr « "File is not recognized by this application" « endl; 
} else if (streamVersion > in.version()) { 

cerr « "File is from a more recent version of the application" 
« endl; 

return false; 

} 

in.setVersion(streamVersion) ; 

Nous pouvons lire les donnees tant que la version du flux est inferieure ou egale a la version 
utilisee par 1' application. Dans le cas contraire, nous signalons une erreur. 

Si le format de fichier contient un numero de version personnel, nous pouvons l'utiliser pour 
deduire le numero de version du flux au lieu de le stocker explicitement. Supposons, par exem- 
ple, que le format de fichier est destine a la version 1.3 de notre application. Nous pouvons 
alors ecrire les donnees comme suit : 

QDataStream out(&file); 

out.setVersion(QDataStream: :Qt_4_1 ) ; 

out « quint32(MagicNumber) « quint16(0x0103) ; 

Lorsque nous les relisons, nous determinons quelle version de QDataStream utiliser selon le 
numero de version de 1' application : 

QDataStream in(&file); 
in » magic » appVersion; 
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if (magic != MagicNumber) { 

cerr « "File is not recognized by this application" « endl; 

return false; 
} else if (appVersion > 0x0103) { 

cerr « "File is from a more recent version of the application" 
« endl; 

return false; 

} 

if (appVersion < 0x0103) { 

in.setVersion(QDataStream: :Qt_3_0) ; 
} else { 

in.setVersion(QDataStream: :Qt_4_1 ) ; 

} 

Dans cet exemple, nous specifions que tout fichier enregistre avec une version anterieure a la 
version 1.3 de 1' application utilise la version de flux de donnees 4 (Qt_3_0) et que les fichiers 
enregistres avec la version 1.3 de 1' application utilisent la version de flux de donnees 7 
(Qt_4_1). 

En resume, il existe trois strategies pour gerer les versions de QDataStream : coder en dur le 
numero de version, ecrire et lire explicitement le numero de version et utiliser differents nume- 
ros de version codes en dur en fonction de la version de 1' application. Toutes peuvent etre 
employees afin d' assurer que les donnees ecrites par une ancienne version d'une application 
peuvent etre lues par une nouvelle version. Une fois cette strategie de gestion des versions de 
QDataStream choisie, la lecture et l'ecriture de donnees binaires au moyen de Qt est a la fois 
simple et fiable. 

Si nous souhaitons lire ou ecrire un fichier en une seule fois, nous pouvons eviter l'utilisation 
de QDataStream et recourir a la place aux fonctions write ( ) et readAll ( ) de QIODevice. 
Par exemple : 

bool copyFile (const QString &source, const QString &dest) 
{ 

QFile sourceFile(source) ; 
if ( !sourceFile.open(QIODevice: :ReadOnly) ) 
return false; 

QFile destFile(dest) ; 
if ( !destFile.open(QIODevice: :WriteOnly) ) 
return false; 

dest File. write ( sou rceFile. readAll ( ) ) ; 

return sourceFile.error() == QFile: :NoError 
&& destFile.error() == QFile: :NoError; 

} 

Sur la ligne de l'appel de readAll( ), le contenu entier du fichier d'entree est lu et place dans 
un QByteArray. II est alors transmis a la fonction write ( ) pour etre ecrit dans le fichier de 
sortie. Le fait d' avoir toutes les donnees dans un QByteArray necessite plus de memoire que 
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de les lire element par element, mais offre quelques avantages. Nous pouvons executer, par 
exemple, qCompress ( ) et qUncompress ( ) pour les compresser et les decompresser. 

II existe d'autres scenarios oil il est plus approprie d'acceder directement a QIODevice que 
d'utiliser QDataStream. QIODevice fournit une fonction peek() qui retourne les octets de 
donnee suivants sans changer l'emplacement du peripherique ainsi qu'une fonction unget- 
Char ( ) qui permet de revenir un octet en arriere. Ceci fonctionne a la fois pour les peripheri- 
ques d'acces aleatoire (tels que les fichiers) et pour les peripheriques sequentiels (tels que les 
sockets reseau). II existe egalement une fonction seek ( ) qui definit la position des periphe- 
riques supportant l'acces aleatoire. 

Les formats de fichier binaires offrent les moyens les plus souples et les plus compacts de stoc- 
kage de donnees. QDataStream facilite l'acces aux donnees binaires. En plus des exemples de 
cette section, nous avons deja etudie l'utilisation de QDataStream au Chapitre4 pour lire et 
ecrire des fichiers de tableur, et nous l'utihserons de nouveau dans le Chapitre 19 pour lire et ecrire 
des fichiers de curseur Windows. 



Lire et ecrire du texte 

Les formats de fichiers binaires sont generalement plus compacts que ceux bases sur le 
texte, mais ils ne sont pas lisibles ou modifiables par l'homme. Si cela represente un 
probleme, il est possible d'utiliser a la place les formats texte. Qt fournit la classe QText- 
Stream pour lire et ecrire des fichiers de texte brut et pour des fichiers utilisant d'autres 
formats texte, tels que HTML, XML et du code source. La gestion des fichiers XML est 
traitee dans le Chapitre 15. 

QTextStream se charge de la conversion entre Unicode et le codage local du systeme ou tout 
autre codage, et gere de facon transparente les conventions de fin de ligne utilisees par les 
differents systemes d' exploitation ("\r\n" sur Windows, "n" sur Unix et Mac OS X). QText- 
Stream utilise le type QChar 16 bits comme unite de donnee fondamentale. En plus des carac- 
teres et des chaines, QTextStream prend en charge les types numeriques de base de C++, qu'il 
convertit en chaines. Par exemple, le code suivant ecrit "Thomas M. Disch : 334" dans le 
fichiersf-book.txt : 

QFile file("sf-book.txt") ; 

if ( !file.open(QIODevice: :WriteOnly) ) { 

cerr « "Cannot open file for writing: " 

« qPrintable(file.errorString( ) ) « endl; 

return; 

} 



QTextStream out(&file); 

out « "Thomas M. Disch: " « 334 « endl; 
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L'ecriture du texte est tres facile, mais sa lecture peut representer un veritable defit, car les 
donnees textuelles (contrairement aux donnees binaires ecrites au moyen de QDataStream) 
sont fondamentalement ambigues. Considerons l'exemple suivant : 

out « "Norway" « "Sweden"; 

Si out est un QTextStream, les donnees veritablement ecrites sont la chaine "NorwaySweden". 
Nous ne pouvons pas vraiment nous attendre a ce que le code suivant lise les donnees correc- 
tement : 

in » strl » str2; 

En fait, strl obtient le mot "NorwaySweden" entier et str2 n'obtient rien. Ce probleme ne 
se pose pas avec QDataStream, car la longueur de chaque chaine est stockee devant les 
donnees. 

Pour les formats de fichier complexes, un analyseur risque d'etre requis. Un tel analyseur peut 
fonctionner en lisant les donnees caractere par caractere en utilisant un » sur un QChar, ou 
ligne par ligne au moyen de QTextStream: : readLine ( ). A la fin de cette section, nous 
presentons deux petits exemples. Le premier lit un fichier d'entree ligne par ligne et l'autre le 
lit caractere par caractere. Pour ce qui est des analyseurs qui traitent le texte entier, nous 
pouvons lire le fichier complet en une seule fois a l'aide de QTextStream: :readAll() si 
nous ne nous preoccupons pas de l'utilisation de la memoire, ou si nous savons que le fichier 
est petit. 

Par defaut, QTextStream utilise le codage local du systeme (par exemple, ISO 8859-1 ou ISO 
8859-15 aux Etats-Unis et dans une grande partie de 1' Europe) pour les operations de lecture et 
d'ecriture. Vous pouvez changer ceci en executant setCodec ( ) comme suit : 

stream. setCodec( "UTF-8" ) ; 

UTF-8 est un codage populaire compatible ASCII capable de representer la totalite du jeu de 
caracteres Unicode. Pour plus d' informations concernant Unicode et la prise en charge des 
codages de QTextStream, reportez-vous au Chapitre 17 (Internationalisation). 

QTextStream possede plusieurs options modelees sur celles offertes par <iostream>. Elles 
peuvent etre definies en transmettant des objets speciaux, nommes manipulateurs de flux, au 
flux pour modifier son etat. L'exemple suivant definit les options showbase, uppercasedigits 
et hex avant la sortie de Tender 12345678, produisant le texte "0xBC614E" : 

out « showbase « uppercasedigits « hex « 12345678; 

Les options peuvent egalement etre definies en utilisant les fonctions membres : 

out . setNumberFlags (QTextStream : : ShowBase 

| QTextStream: :UppercaseDigits) ; 
out.setIntegerBase(16) ; 
out « 12345678; 
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setIntegerBase(int ) 


0 


Detection automatique basee sur le prefixe (lors de la lecture) 


2 


Binaire 


8 Octal 


10 


Decimal 


16 


Hexadecimal 





setNumberFlags(NumberFlags) 



ShowBase 


Affiche un prefixe si la base est 2 ("Ob"), 8 ("0") ou 16 ("Ox") 


ForceSign 


Affiche toujours le signe des nombres reels 


ForcePoint 


Place toujours le separateur de decimale dans les nombres 


UppercaseBase 


Utilise les versions majuscules des prefixes de base ("OX", "OB") 



UppercaseDigits Utilise des lettres majuscules dans les nombres hexadecimaux 



setRealNumberNotation (RealNumberNotation) 



FixedNotation 


Notation a point fixe (par exemple, 


"0.000123") 


Scientif icNotation 


Notation scientifique (par exemple. 


"1.234568e-04") 



SmartNotation Notation la plus compacte entre point fixe ou scientifique 



setRealNumberPrecision (int ) 

Definit le nombre maximum de chiffres devant etre generes (6 par defaut) 



setFieldWidth(int) 

Definit la taille minimum d'un champ (0 par defaut) 
setFieldAlignment (FieldAlignment ) 

AlignLef t Force un alignement sur le cote gauche du champ 

AlignRight Force un alignement sur le cote droit du champ 

AlignCenter Force un alignement sur les deux cotes du champ 

AlignAccountingStyle Force un alignement entre le signe et le nombre 



setPadChar(QChar) 

Defini le caractere a utiliser pour 1' alignement (espace par defaut) 



Figure 12.1 

Fonctions destinies d definir les options de QTextStream 
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Comme QDataStream, QTextStream agit sur une sous-classe de QIODevice, qui peut etre un 
QFile, un QTemporaryFile, un QBuf f er, un QProcess, un QTcpSocket ou un 
QUdpSocket. En outre, il peut etre utilise directement sur un QString. Par exemple : 

QString str; 

QTextStream(&str) « oct « 31 « " " « dec « 25 « endl; 

Le contenu de str est done "37 25/n", car le nombre decimal 31 est exprime sous la forme 37 
en base huit. Dans ce cas, il n'est pas necessaire de definir un codage sur le flux, car QString 
est toujours Unicode. 

Examinons un exemple simple de format de fichier base sur du texte. Dans 1' application 
Spreadsheet decrite dans la Partie 1, nous avons utilise un format binaire pour stacker les 
donnees. Ces donnees consistaient en une sequence de triplets (ligne, colonne, formule), une 
pour chaque cellule non vide. II n'est pas difficile d'ecrire les donnees sous forme de texte. 
Voici un extrait d'une version revisee de Spreadsheet : : writeFile ( ). 

QTextStream out(&file); 

for (int row = 0; row < RowCount; ++row) { 

for (int column = 0; column < ColumnCount; ++column) { 
QString str = formulafrow, column); 
if ( !str.isEmpty() ) 

out « row « " " « column « " " « str « endl; 

} 

} 

Nous avons utilise un format simple, chaque ligne representant une cellule avec des espaces 
entre la ligne et la colonne ainsi qu'entre la colonne et la formule. La formule contient des 
espaces, mais nous pouvons supposer qu'elle ne comporte aucun 7n' (qui insere un retour a la 
ligne). Examinons maintenant le code de lecture correspondant : 

QTextStream in(&file) ; 
while (Iin.atEnd()) { 

QString line = in . readLine( ) ; 
QStringList fields = line. split (' '); 
if (fields. size() >= 3) { 

int row = fields. takeFirst() .toInt() ; 
int column = fields. takeFirstf) .toInt() ; 
setFormula(row, column, fields. join( 1 ')); 

} 

} 

Nous lisons les donnees de Spreadsheet ligne par ligne. La fonction readLine ( ) supprime le 
7n' de fin. QString: : split () retourne une liste de chaines de caracteres qui est scindee a 
l'emplacement d'apparition du separateur qui lui est fournit. Par exemple, la ligne "5 19 Total 
Value" resulte en une liste de quatre elements ["5", "19", "Total", "Value"]. 

Si nous disposons au moins de trois champs, nous sommes prets a extraire les donnees. La 
fonction QStringList: :takeFirst() supprime le premier element d'une liste et retourne 
l'element supprime. Nous l'utilisons pour extraire les nombres de ligne et de colonne. 
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Nous ne realisons aucune verification d'erreur. Si nous lisons une valeur de ligne ou de 
colonne non entiere, QString: :toInt() retoume 0. Lorsque nous appelons setFormula( ), 
nous devons concatener les champs restants en une seule chaine. 

Dans notre deuxieme exemple de QTextStream, nous utilisons une approche caractere par 
caractere pour implementer un programme qui lit un fichier texte et emet en sortie le meme 
texte avec les espaces de fin supprimes et toutes les tabulations remplacees par des espaces. 
Le programme accomplit cette tache dans la fonction tidyFile() : 

void tidyFilefQIODevice *inDevice, QIODevice *outDevice) 
{ 

QTextStream in(inDevice) ; 
QTextStream out(outDevice) ; 

const int TabSize = 8; 
int endlCount = 0; 
int spaceCount = 0; 
int column = 0; 
QChar ch; 

while (!in.atEnd()) { 
in » ch; 

if (ch == '\n') { 
++endlCount; 
spaceCount = 0; 
column = 0; 
} else if (ch == '\t') { 

int size = TabSize - (column % TabSize); 
spaceCount += size; 
column += size; 
} else if (ch == 1 ') { 
++spaceCount; 
++column; 
} else { 

while (endlCount > 0) { 
out « endl; 
--endlCount; 
column = 0; 

} 

while (spaceCount > 0) { 
out « 1 1 ; 
--spaceCount; 
++column; 

} 

out « ch; 
++column; 

} 

} 

out « endl; 

} 
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Nous creons un QTextStream d'entree et de sortie base sur les QIODevice transmis a la fonc- 
tion. Nous conservons trois elements d'etat : un decompte des nouvelles lignes, un decompte 
des espaces et 1' emplacement de colonne courant dans la ligne en cours (pour convertir les 
tabulations en un nombre d' espaces correct). 

L' analyse est faite dans une boucle while qui parcourt chaque caractere du fichier d'entree. Le 
code presente quelques subtilites a certains endroits. Par exemple, bien que nous derinissions 
tabSize en 8, nous remplacons les tabulations par le nombre d'espaces qui permet d'atteindre 
le taquet de tabulation suivant, au lieu de remplacer grossierement chaque tabulation par huit 
espaces. Dans le cas d'une nouvelle ligne, d'une nouvelle tabulation ou d'un nouvel espace, 
nous mettons simplement a jour les donnees d'etat. Pour les autres types de caracteres, nous 
produisons une sortie. Avant d'ecrire le caractere nous introduisons tous les espaces et les 
nouvelles lignes necessaires (pour respecter les lignes vierges et preserver le retrait) et mettons 
a jour l'etat. 

int main() 
{ 

QFile inFile; 
QFile outFile; 

inFile. open (stdin, QFile: :ReadOnly) ; 
outFile. openfstdout, QFile: :WriteOnly) ; 

tidyFile(&inFile, &outFile); 

return 0; 

} 

Pour cet exemple, nous n'avons pas besoin d'objet QApplication, car nous n'utilisons que 
les classes d'outils de Qt. Vous trouverez la liste de toutes les classes d'outils a l'adresse 
http://doc.trolltech.eom/4.l/tools.html. Nous avons suppose que le programme est utilise en 
tant que filtre, par exemple : 

tidy < cool.cpp > cooler. epp 

II serait facile de le developper afin de gerer les noms de fichier qui seraient transmis sur la 
ligne de commande ainsi que pour filtrer cinencout. 

Comme il s'agit d'une application de console, le fichier . pro differe legerement de ceux que 
nous avons rencontres pour les applications GUI : 

TEMPLATE = app 

QT = core 

CONFIG += console 

CONFIG -= app_bundle 

SOURCES = tidy.cpp 

Nous n'etablissons de liaison qu'avec QtCore, car nous n'utilisons aucune fonctionnalite GUI. 
Puis nous specifions que nous souhaitons activer la sortie de la console sur Windows et que 
nous ne voulons pas que 1' application soit hebergee dans un package sur Mac OS X. 
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Pour lire et ecrire des fichiers ASCII ou ISO 8859-1 (Latin-1) bruts, il est possible d'utiliser 
directement l'API de QIODevice au lieu de QTextStream. Mais cette methode est rarement 
conseillee dans la mesure oil la plupart des applications doivent prendre en charge d'autres 
codages a un stade ou a un autre, et oil seul QTextStream offre une prise en charge parfaite de 
ces codages. Si vous souhaitez neanmoins ecrire le texte directement dans un QIODevice, 
vous devez specifier explicitement la balise QIODevice: :Text dans la fonction open(). 
Par exemple : 

file.open(QIODevice: :WriteOnly | QIODevice: : Text) ; 

Lors de l'ecriture, cette balise indique a QIODevice de convertir les caracteres '\n' en des 
sequences "\r\n" sur Windows. Lors de la lecture, elle indique au peripherique d'ignorer les 
caracteres 'r' sur toutes les plates-formes. Nous pouvons alors supposer que la fin de chaque 
ligne est marquee par un caractere de nouvelle ligne 'n' quelle que soit la convention de fin de 
ligne utilisee par le systeme d' exploitation. 

Parcourir les repertoires 

La classe QDir fournit un moyen independant de la plate-forme de parcourir les repertoires et 
de recuperer des informations concernant les fichiers. Pour determiner comment QDir est utili- 
see, nous allons ecrire une petite application de console qui calcule l'espace occupe par toutes 
les images d'un repertoire particulier et de tous ses sous-repertoires, quelle que soit leur 
profondeur. 

Le coeur de l'application est la fonction imageSpace ( ), qui calcule recursivement la taille 
cumulee des images d'un repertoire donne : 

qlonglong imageSpace (const QString &path) 
{ 

QDir dir(path) ; 
qlonglong size = 0; 

QStringList filters; 

foreach (QByteArray format, QlmageReader: :supportedImageFormats( ) ) 
filters += "*." + format; 

foreach (QString file, dir.entryList(filters, QDir: : Files) ) 
size += QFilelnfofdir, file) .size() ; 

foreach (QString subDir, dir.entryList(QDir: :Dirs 

| QDir: :NoDotAndDotDot)) 
size += imageSpace (path + QDir: :separator() + subDir); 

return size; 

} 
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Nous commencons par creer un objet QDir en utilisant un chemin donne, qui peut etre relatif 
au repertoire courant ou absolu. Nous transmettons deux arguments a la fonction 
entry List ( ). Le premier est une liste de filtres de noms de fichiers. lis peuvent contenir les 
caracteres generiques '*' et '?.' Dans cet exemple, nous realisons un filtrage de facon a 
n'inclure que les formats de fichiers susceptibles d'etre lus par Qlmage. Le second argument 
specifie le type d'entree souhaite (fichiers normaux, repertoires, etc.). 

Nous parcourons la liste de fichiers, en additionnant leurs tallies. La classe QFilelnf o nous 
permet d'acceder aux attributs d'un fichier, tels que la faille, les autorisations, le proprietaire et 
l'horodateur de ce fichier. 

Le deuxieme appel de entry List ( ) recupere tous les sous-repertoires de ce repertoire. Nous 
les parcourons et nous appelons imageSpace ( ) recursivement pour etablir la faille cumulee de 
leurs images. 

Pour creer le chemin de chaque sous-repertoire, nous combinons de chemin du repertoire en 
cours avec le nom du sous-repertoire, en les separant par un slash (/). 

QDir traite '/' comme un separateur de repertoires sur toutes les plates-formes. Pour presenter 
les chemins a l'utilisateur, nous pouvons appeler la fonction statique QDir: : convertSepa- 
rators ( ) qui convertit les slash en separateurs specifiques a la plate -forme. 

Ajoutons une fonction main ( ) a notre petit programme : 

int mainfint argc, char *argv[]) 
{ 

QCoreApplication appfargc, argv); 
QStringList args = app. arguments () ; 

QString path = QDir: :currentPath() ; 
if (args.count( ) > 1) 
path = args[ 1 ] ; 

cout « "Space used by images in " « qPrintable(path) 

« " and its subdirectories is " « (imageSpace(path) / 1024) 
« " KB" « endl; 

return 0; 

} 

Nous utilisons QDir: :currentPath() pour initialiser le chemin vers le repertoire courant. 
Nous aurions aussi pu faire appel a QDir : : homePath ( ) pour l'initialiser avec le repertoire de 
base de l'utilisateur. Si ce dernier a specifie un chemin sur la ligne de commande, nous l'utili- 
sons a la place. Nous appelons enfin notre fonction imageSpace ( ) pour calculer l'espace 
occupe par les images. 

La classe QDir fournit d'autres fonctions liees aux repertoires et aux fichiers, dont entrylnf o- 
List() (qui retourne une liste d'objets QFilelnfo), rename(), exists(), mkdir() et 
rmdir ( ) . La classe QFile fournit des fonctions utilitaires statiques, dont remove ( ) et exists ( ) . 
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Integration des ressources 

Jusqu'a present, nous avons etudie l'acces aux donnees dans des peripheriques externes, mais 
avec Qt, il est egalement possible d'integrer du texte ou des donnees binaires dans l'executable 
de 1' application. Pour ce faire, il convient d'utiliser le systeme de ressources de Qt. Dans 
les autres chapitres, nous avons utilise les fichiers de ressources pour integrer des images 
dans l'executable, mais il est possible d'integrer tout type de fichier. Les fichiers integres 
peuvent etre lus au moyen de QFile, exactement comme les fichiers normaux d'un systeme de 
fichiers. 

Les ressources sont converties en code C++ par rcc, le compilateur de ressources de Qt. Nous 
pouvons demander a qmake d'inclure des regies speciales d'execution de rcc en ajoutant cette 
ligne au fichier .pro : 

RESOURCES = myresourcefile.qrc 

myresourcef ile . qrc est un fichier XML qui repertorie les fichiers a integrer dans l'executa- 
ble. 

Imaginons que nous ecrivions une application destinee a repertorier des coordonnees. Pour des 
raisons pratiques, nous souhaitons integrer les indicatifs telephoniques internationaux dans 
l'executable. Si le fichier se situe dans le repertoire dataf iles de 1' application, le fichier de 
ressources serait le suivant : 

<!D0CTYPE RCC><RCC version=" 1 .0"> 
<qresource> 

<file>dataf iles /phone- codes .dat</file> 
</qresource> 
</RCC> 

Depuis 1' application, les ressources sont identifiees par le prefixe de chemin : / . Dans cet exemple, 
le chemin du fichier contenant les indicatifs telephoniques est :/dataf iles/phone- 
codes . dat et peut etre lu comme tout autre fichier en utilisant QFile. 

L'integration de donnees dans l'executable presente plusieurs avantages : les donnees ne 
peuvent etre perdues et cette operation permet la creation d'executables veritablement auto- 
nomes (si une liaison statique est egalement utilisee). Les inconvenients sont les suivants : si 
les donnees integrees doivent etre changees, il est imperatif de remplacer l'executable entier, et 
la taille de ce dernier sera plus importante car il doit s'adapter aux donnees integrees. 

Le systeme de ressources de Qt fournit des fonctionnalites supplementaires, telles que la prise 
en charge des alias de noms de fichiers et la localisation. Ces fonctionnalites sont documentees 
a l'adresse http://doc.trolltech.eom/4.l/resources.html. 
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Communication inter-processus 

La classe QProcess nous permet d'executer des programmes externes et d'interagir avec 
ceux-ci. La classe fonctionne de facon asynchrone, effectuant sa tache a l'arriere-plan de sorte 
que l'interface utilisateur reste reactive. QProcess emet des signaux pour nous indiquer quand 
le processus externe detient des donnees ou a termine. 

Nous allons reviser le code d'une petite application qui fournit une interface utilisateur pour un 
programme externe de conversion des images. Pour cet exemple, nous nous reposons sur le 
programme ImageMagick convert, qui est disponible gratuitement sur toutes les plates- 
formes principales. (Voir Figure 12.2) 



Figure 12.2 

U application 
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L'interface utilisateur a ete creee dans Qt Designer. Le fichier . ui se trouve sur le site web de 
Pearson, www.pearson.fr, a la page dediee a ce livre. Ici, nous allons nous concentrer sur 
la sous-classe qui herite de la classe Ui: : Conver.tDialog generee par le compilateur 
d'interface utilisateur. Commencons par l'en-tete : 

#ifndef CONVERTDIALOG_H 
#define CONVERTDIALOGJH 

#include <QDialog> 
#include <QProcess> 

#include "ui_convertdialog.h" 

class ConvertDialog : public QDialog, public Ui: :ConvertDialog 
{ 

Q_OBJECT 
public: 

ConvertDialog(QWidget *parent = 0); 
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private slots: 

void on_browseButton_clicked( ) ; 

void on_convertButton_clicked( ) ; 

void updateOutputTextEditf ) ; 

void processFinishedfint exitCode, QProcess: :ExitStatus exitStatus); 

void processError(QProcess: :ProcessError error); 

private: 

QProcess process; 
QString targetFile; 

}; 

#endif 

L'en-tete est conforme a celui d'une sous-classe de formulaire Qt Designer. Grace au meca- 
nisme de connexion automatique de Qt Designer, les slots on_browseButton_clicked ( ) et 
on_convertButton_clicked ( ) sont automatiquement connectes aux signaux clicked () 
des boutons Browse et Convert. 

ConvertDialog: :ConvertDialog(QWidget *parent) 
: QDialog(parent) 

{ 

setupUi(this) ; 

connect (&process, SIGNAL ( readyReadStandardError ( ) ) , 

this, SLOTfupdateOutputTextEdit ( ) ) ) ; 
connect(&process, SIGNAL (finished (int, QProcess :: ExitStatus) ) , 

this, SLOT(processFinished(int, QProcess: : ExitStatus) )) ; 
connectf&process, SIGNAL(error(QProcess: :ProcessError) ) , 

this, SLOT(processError(QProcess: :ProcessError) ) ) ; 

} 

L'appel de setupUi ( ) cree et positionne tous les widgets du formulaire, etablit les connexions 
signal/slot pour les slots on_obj ectName_signalName ( ) et connecte le bouton Quit a 
QDialog : : accept ( ). Nous connectons ensuite manuellement trois signaux de l'objet QPro- 
cess a trois slots prives. A chaque fois que le processus externe va detecter des donnees sur 
son cerr, il les gerera avec updateOutputTextEdit ( ). 

void ConvertDialog: :on_browseButton_clicked( ) 
{ 

QString initialName = sourceFileEdit->text() ; 
if (initialName. isEmpty()) 

initialName = QDir: :homePath() ; 
QString fileName = 

QFileDialog: :getOpenFileName(this, tr( "Choose File"), 

initialName) ; 
fileName = QDir: :convertSeparators(fileName) ; 
if ( !f ileName. isEmpty ( ) ) { 

sou rceFileEdit->setText (fileName) ; 
convertButton->setEnabled(true) ; 

} 

} 
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Le signal clicked () du bouton Browse est automatiquement connects au slot 
on_browseButton_clicked ( ) par setupUi(). Si l'utilisateur a prealablement selectionne 
un fichier, nous initialisons la boite de dialogue avec le nom de ce fichier. Sinon, nous prenons 
le repertoire de base de l'utilisateur. 

void ConvertDialog: :on_convertButton_clicked( ) 
{ 

QString sourceFile = sourceFileEdit->text( ) ; 

targetFile = QFilelnfo(sourceFile) .path() + QDir: :separator() 

+ QFilelnf o(sourceFile) .baseNamef) + "." 

+ targetFormatComboBox->currentText( ) .toLower( ) ; 
convertButton->setEnabled (false) ; 
outputTextEdit->clear( ) ; 

QStringList args; 

if (enhanceCheckBox->isChecked() ) 

args « "-enhance" ; 
if (monochromeCheckBox->isChecked ( ) ) 

args « "-monochrome"; 
args « sourceFile « targetFile; 

process. start ( "convert" , args) ; 

} 

Lorsque l'utilisateur clique sur le bouton Convert, nous copions le nom du fichier source et 
changeons l'extension afin qu'elle corresponde au format du fichier cible. 

Nous utilisons le separateur de repertoires specifique a la plate-forme ('/' ou 'V, disponible 
sous la forme QDir : : separator ( ) ) au lieu de coder les slash en dur, car le nom du fichier 
sera visible pour l'utilisateur. 

Nous desactivons alors le bouton Convert pour eviter que l'utilisateur ne lance accidentel- 
lement plusieurs conversions, et nous effacons l'editeur de texte qui nous permet d'afficher les 
informations d'etat. 

Pour lancer le processus externe, nous appelons QProcess :: start ( ) avec le nom du 
programme a executer (convert) et tous les arguments requis. Dans ce cas, nous transmettons 
les balises -enhance et -monochrome si l'utilisateur a coche les options appropriees, suivies 
des noms des fichiers source et cible. Le programme convert deduit la conversion requise a 
partir des extensions de fichier. 

void ConvertDialog : : updateOutputTextEdit ( ) 
{ 

QByteArray newData = process. readAHStandardError( ) ; 
QString text = outputTextEdit->toPlainText() 

+ QString: :f romLocal8Bit (newData) ; 
out putTextEdit->setPlainText (text) ; 

} 
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Lorsque le processus externe effectue une operation d'ecriture dans le cerr, le slot upda- 
teOutputTextEdit ( ) est appele. Nous lisons le texte d'erreur et l'ajoutons au texte existant 
de QTextEdit. 

void ConvertDialog: :processFinished(int exitCode, 

QProcess: :ExitStatus exitStatus) 

{ 

if (exitStatus == QProcess: :CrashExit) { 

outputTextEdit->append(tr( "Conversion program crashed")); 

} else if (exitCode != 0) { 

outputTextEdit->append(tr( "Conversion failed" ) ) ; 

} else { 

outputTextEdit->append(tr( "File %1 created") .arg(targetFile) ) ; 

} 

convertButton->setEnabled(true) ; 

} 

Une fois le processus termine, nous faisons connaitre le resultat a l'utilisateur et activons le 
bouton Convert. 

void ConvertDialog: :processError(QProcess: :ProcessError error) 
{ 

if (error == QProcess: :FailedToStart) { 

outputTextEdit->append(tr( "Conversion program not found")); 
convertButton->setEnabled(true) ; 

} 

} 

Si le processus ne peut etre lance, QProcess emet error () au lieu de finished(). Nous 
rapportons toute erreur et activons le bouton Click. 

Dans cet exemple, nous avons effectue les conversions de fichier de fagon asynchrone - nous 
avons demande a QProcess d'executer le programme convert et de rendre immediatement le 
controle a 1' application. Cette methode laisse l'interface utilisateur reactive puisque le proces- 
sus s'execute a l'arriere-plan. Mais dans certains cas, il est necessaire que le processus externe 
soit termine avant de pouvoir poursuivre avec notre application. Dans de telles situations, 
QProcess doit agir de fagon synchrone. 

Les applications qui prennent en charge 1' edition de texte brut dans l'editeur de texte prefere de 
l'utilisateur sont typiques de celles dont le comportement doit etre synchrone. L'implementa- 
tion s'obtient facilement en utilisant QProcess. Supposons, par exemple, que le texte brut se 
trouve dans un QTextEdit, et que vous fournissiez un bouton Edit sur lequel T utilisateur peut 
cliquer, connecte a un slot edit ( ) . 

void ExternalEditor: :edit() 
{ 

QTemporaryFile outFile; 
if ( !outFile.open( ) ) 
return; 

QString fileName = outFile. fileName() ; 
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QTextStream out(&outFile) ; 

out « textEdit->toPlainText() ; 

outFile. close() ; 

QProcess: :execute(editor, QStringListf) « options « fileName); 

QFile inFile(f ileName) ; 
if ( !inFile.open(QIODevice: :ReadOnly) ) 
return; 

QTextStream in(&inFile); 

text Edit- >setPlainText (in. readAll( ) ) ; 

} 

Nous utilisons QTemporaryFile pour creer un fichier vide avec un nom unique. Nous ne 
specifions aucun argument pour QTemporaryFile: :open() puisqu'elle est judicieusement 
definie pour ouvrir en mode ecriture/lecture par defaut. Nous ecrivons le contenu de l'editeur 
de texte dans le fichier temporaire, puis nous fermons ce dernier car certains editeurs de texte 
ne peuvent travailler avec des fichiers deja ou verts. 

La fonction statique QProcess: : execute () execute un processus externe et provoque un 
blocage jusqu'a ce que le processus soit termine. L'argument editor est un QString conte- 
nant le nom d'un executable editeur ("gvim", par exemple). L'argument options est un 
QStringList (contenant un element, "-f", si nous utilisons gvim). 

Une fois que l'utilisateur a ferme l'editeur de texte, le processus se termine ainsi que l'appel de 
execute ( ). Nous ouvrons alors le fichier temporaire et lisons son contenu dans le QText- 
Edit. QTemporaryFile supprime automatiquement le fichier temporaire lorsque l'objet sort 
de la portee. 

Les connexions signal/slot ne sont pas necessaires lorsque QProcess est utilise de facon 
synchrone. Si un controle plus fin que celui fourni par la fonction statique execute () est 
requis, nous pouvons utiliser une autre approche qui implique de creer un objet QProcess et 
d'appeler start ( ) sur celui-ci, puis de forcer un blocage en appelant QProcess : : waitFor- 
Started( ), et en cas de succes, en appelant QProcess : : waitForFinished ( ). Reportez-vous 
a la documentation de reference de QProcess pour trouver un exemple utilisant cette approche. 

Dans cette section, nous avons exploite QProcess pour obtenir l'acces a une fonctionnalite 
preexistante. L'utilisation d' applications deja existantes represente un gain de temps et vous 
evite d' avoir a resoudre des problemes tres eloignes de l'objectif principal de votre application. 
Une autre facon d' acceder a une fonctionnalite preexistante consiste a etablir une liaison vers 
une bibliotheque qui la fournit. Si une telle bibliotheque n'existe pas, vous pouvez aussi envi- 
sager d'encapsuler votre application de console dans un QProcess. 

QProcess peut egalement servir a lancer d'autres applications GUI, telles qu'un navigateur 
Web ou un client email. Si, cependant, votre objectif est la communication entre applications et 
non la simple execution de l'une a partir de 1' autre, il serait preferable de les faire communi- 
quer directement en utilisant les classes de gestion de reseau de Qt ou 1' extension ActiveQt sur 
Windows. 
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Au sommaire de ce chapitre 

i/ Connexion et execution de requetes 

%/ Presenter les donnees sous une forme tabulaire 

\/ Implementer des formulaires maitre/detail 



Le module QtSql fournit une interface independante de la plate -forme pour acceder aux 
bases de donnees. Cette interface est prise en charge par un ensemble de classes qui 
utilisent 1' architecture modele/vue de Qt pour integrer la base de donnees a 1' interface 
utilisateur. Ce chapitre suppose une certaine familiarite avec les classes modele/vue de 
Qt, traitees dans le Chapitre 10. 
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Une connexion de base de donnees est representee par un objet QSqlDatabase. Qt utilise des 
pilotes pour communiquer avec les diverses API de base de donnees. Qt Desktop Edition inclut 
les pilotes suivants : 



Pilote 


Base de donnees 


QDB2 


IBM DB2 version 7.1 et ulterieure 


QIBASE 


Borland InterBase 


QMYSQL 


MySQL 


QOCI 


Oracle (Oracle Call Interface) 


QODBC 


ODBC (inclut Microsoft SQL Server) 


QPSQL 


PostgreSQL versions 6.x et 7.x 


QSQLITE 


SQLite version 3 et ulterieure 


QSQLITE2 


SQLite version 2 


QTDS 


Sybase Adaptive Server 



Tous les pilotes ne sont pas fournis avec Qt Open Source Edition, en raison de restrictions de 
licence. Lors de la configuration de Qt, nous pouvons choisir entre inclure directement les pilo- 
tes SQL a Qt et les creer en tant que plugin. Qt est fourni avec la base de donnees SQLite, une 
base de donnees in-process (qui s'integre aux applications) de domaine public. 

Pour les utilisateurs familiarises avec la syntaxe SQL, la classe QSqlQuery represente un bon 
moyen d'executer directement des instructions SQL arbitraires et de gerer leurs resultats. Pour 
les utilisateurs qui preferent une interface de base de donnees plus evoluee masquant la syntaxe 
SQL, QSqlTableModel et QSqlRelationalTableModel foumissent des abstractions accep- 
tables. Ces classes representent une table SQL de la meme facon que les autres classes modele 
de Qt (traitees dans le Chapitre 10).Elles peuvent etre utilisees de facon autonome pour 
parcourir et modifier des donnees dans le code, ou encore etre associees a des vues par le biais 
desquelles les utilisateurs finaux peuvent afficher et modifier les donnees. 

Connexion et execution de requetes 

Pour executer des requetes SQL, nous devons tout d'abord etablir une connexion avec une base 
de donnees. En regie generale, les connexions aux bases de donnees sont definies dans une 
fonction separee que nous appelons au lancement de 1' application. Par exemple : 

bool createConnection( ) 
{ 

QSqlDatabase db = QSqlDatabase: :addDatabase(" QMYSQL") ; 
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db . setHostName ( "mozart . konkordia . edu " ) ; 
db.setDatabaseName( "musicdb" ) ; 
db.setUserName("gbatstone") ; 
db. set Password ( "T17aV44" ) ; 
if (Idb.openO) { 

QMessageBox: :critical(0, QObject: :tr( "Database Error"), 

db.lastErrorf ) .text ( ) ) ; 

return false; 

} 

return true; 

} 

Dans un premier temps, nous appelons QSqlDatabase : : addDatabase ( ) pour creer un objet 
QSqlDatabase. Le premier argument de addDatabase ( ) specifie quel pilote doit etre utilise 
par Qt pour acceder a la base de donnees. Dans ce cas, nous utilisons MySQL. 

Nous definissons ensuite le nom de l'hote de la base de donnees, le nom de cette base de 
donnees, le nom d'utilisateur et le mot de passe, puis nous ouvrons la connexion. Si open ( ) 
echoue, nous affichons un message d'erreur. 

Nous appelons generalement createConnection ( ) dans main( ) : 

int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
if ( !createConnection( ) ) 
return 1 ; 

return app.exec() ; 

} 

Une fois qu'une connexion est etablie, nous pouvons utiliser QSqlQuery pour executer toute 
instruction SQL supportee par la base de donnees concernee. Par exemple, voici comment 
executer une instruction SELECT : 

QSqlQuery query; 

query. exec( "SELECT title, year FROM cd WHERE year >= 1998"); 

Apres l'appel d'exec ( ) , nous pouvons parcourir l'ensemble de resultats de la requete : 

while (query. next( ) ) { 

QString title = query .value(0) .toString( ) ; 

int year = query. value(1 ) .toInt( ) ; 

cerr « qPrintable(title) « ": " « year « endl; 

} 

Au premier appel de next(), QSqlQuery est positionne sur le premier enregistrement de 
l'ensemble de resultats. Les appels ulterieurs a next ( ) permettent d'avancer le pointeur vers 
les enregistrements successifs, jusqu'a ce que la fin soit atteinte. A ce stade, next ( ) retourne 
false. Si l'ensemble de resultats est vide (ou si la requete a echoue), le premier appel a 
next ( ) retourne false. 
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La fonction value ( ) retourne la valeur d'un champ en tant que QVariant. Les champs sont 
numerates en partant de 0 dans l'ordre fourni dans l'instruction SELECT. La classe QVariant 
peut contenir de nombreux types Qt et C++, dont int et QString. Les differents types de 
donnees susceptibles d'etre stockes dans une base de donnees sont transformed en types Qt et 
C++ correspondants et stockes en tant que QVariant. Par exemple, un VARCHAR est represents 
en tant que QString et un DATETIME en tant que QDateTime. 

QSqlQuery fournit quelques autres fonctions destinees a parcourir l'ensemble de resultats : 
first (), last(), previous () et seek (). Ces fonctions sont pratiques, mais pour certaines 
bases de donnees elles peuvent s'averer plus lentes et plus gourmandes en memoire que 
next ( ) . Pour optimiser facilement dans le cas de jeux de donnees de taille importante, nous 
pouvons appeler QSqlQuery: : setForwardOnly (true) avant d'appeler exec(), puis 
seulement utiliser next ( ) pour parcourir l'ensemble de resultats. 

Nous avons precedemment presente la requete SQL comme un argument de QSql- 
Query : : exec ( ), mais il est egalement possible de la transmettre directement au constructeur, 
qui l'execute immediatement : 

QSqlQuery query( "SELECT title, year FROM cd WHERE year >= 1998"); 

Nous pouvons controler l'existence d'une erreur en appelant isActive ( ) sur la requete : 

if ( ! query . isActive ( ) ) 

QMessageBox: :warning(this, tr("Database Error"), 
query. lastError ( ) .text( ) ) ; 

Si aucune erreur n'apparait, la requete devient "active" et nous pouvons utiliser next( ) pour 
parcourir l'ensemble de resultats. 

II est presque aussi facile de realiser un INSERT que d'effectuer un SELECT : 

QSqlQuery query( " INSERT INTO cd (id, artistid, title, year) " 

"VALUES (203, 102, 'Living in America 1 , 2002)"); 

Apres cette operation, numRowsAf f ected ( ) retourne le nombre de lignes affectees par 
l'instruction SQL (ou -1 en cas d'erreur). 

Si nous devons inserer de nombreux enregistrements, ou si nous souhaitons eviter la conver- 
sion de valeurs en chaines, nous pouvons recourir a prepare() pour executer une requete 
contenant des emplacements reserves puis lier les valeurs a inserer. Qt prend en charge a la fois 
la syntaxe de style ODBC et celle de style Oracle pour les espaces reserves, en utilisant le 
support natif lorsqu'il est disponible et en le simulant dans les autres cas. Voici un exemple 
utilisant la syntaxe de style Oracle avec des espaces reserves nommes : 

QSqlQuery query; 

query. prepare ("INSERT INTO cd (id, artistid, title, year) " 

"VALUES (:id, :artistid, :title, :year)"); 
query . bindValue( " :id" , 203); 
query . bindValue( " : artistid" , 102) ; 
query. bindValue( " :title" , "Living in America"); 
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query . bindValue( " :year" , 2002) ; 
query. exec() ; 

Voici le meme exemple utilisant des espaces reserves positionnels de style ODBC : 
QSqlQuery query; 

query. prepare ("INSERT INTO cd (id, artistid, title, year) " 

"VALUES (?, ?, ?, ?)"); 
query. addBindValue(203) ; 
query. addBindValue(102) ; 
query. addBindValuef'Living in America"); 
query. addBindValue(2002) ; 
query. exec() ; 

Apres l'appel a exec( ), nous pouvons appeler bindValue( ) ou addBindValue ( ) pour Her 
de nouvelles valeurs, puis nous appelons de nouveau exec ( ) pour executer la requete avec ces 
nouvelles valeurs. 

Les espaces reserves sont souvent utilises pour des donnees binaires contenant des caracteres 
non ASCII ou n'appartenant pas au jeu de caracteres Latin- 1. A 1' arriere-plan, Qt utilise 
Unicode avec les bases de donnees qui prennent en charge cette norme. Pour les autres, Qt 
convertit de facon transparente les chaines en codage approprie. 

Qt supporte les transactions SQL sur les bases de donnees pour lesquelles elles sont disponi- 
bles. Pour lancer une transaction, nous appelons transaction ( ) sur l'objet QSqlDatabase 
qui represente la connexion de base de donnees. Pour mettre fin a la transaction, nous appelons 
soit commit ( ) , soit rollback ( ) . Voici, par exemple, comment rechercher une cle etrangere et 
executer une instruction INSERT dans une transaction : 

QSqlDatabase: :database() .transaction( ) ; 
QSqlQuery query; 

query. exec ( "SELECT id FROM artist WHERE name = 'Gluecifer 1 " ) ; 
if (query. next()) { 

int artistid = query. value(0) .toInt() ; 

query. exec ("INSERT INTO cd (id, artistid, title, year) " 

"VALUES (201, " + QString: : number(artistld) 
+ ", 'Riding the Tiger 1 , 1997)"); 

} 

QSqlDatabase: :database() . commit () ; 

La fonction QSqlDatabase: : database () retourne un objet QSqlDatabase representant la 
connexion creee dans createConnection ( ). Si une transaction ne peut etre demarree, QSql- 
Database: : transaction ( ) retourne false. Certaines bases de donnees ne supportent pas 
les transactions. Dans cette situation, les fonctions transaction ( ), commit () et roll- 
back ( ) n'ont aucune action. Nous pouvons determiner si une base de donnees prend en charge 
les transactions en executant hasFeature ( ) sur le QSqlDriver associe a cette base : 

QSqlDriver *driver = QSqlDatabase: :database() .driver() ; 
if (driver->hasFeature(QSqlDriver: :Transactions) ) 
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Plusieurs autres fonctionnalites de bases de donnees peuvent etre testees, notamment la prise 
en charge des BLOB (objets binaires volumineux), d'Unicode et des requetes preparees. 

Dans les exemples fournis jusqu'a present, nous avons suppose que 1' application utilise une 
seule connexion de base de donnees. Pour creer plusieurs connexions, il est possible de trans- 
mettre un nom en tant que second argument a addDatabase ( ) . Par exemple : 

QSqlDatabase db = QSqlDatabase: : addDatabase ( "QPSQL" , "OTHER"); 
db.setHostName( "saturn.mcmanamy.edu" ) ; 
db.setDatabaseNamef "starsdb" ) ; 
db.setUserName( "hilbert" ) ; 
db.setPassword( "ixtapa7" ) ; 

Nous pouvons alors obtenir un pointeur vers l'objet QSqlDatabase en transmettant le nom a 
QSqlDatabase : : database ( ) : 

QSqlDatabase db = QSqlDatabase: :database( "OTHER" ) ; 

Pour executer des requetes en utilisant 1'autre connexion, nous transmettons l'objet QSqlData- 
base au constructeur de QSqlQuery : 

QSqlQuery query(db) ; 

query. exec ( "SELECT id FROM artist WHERE name = 'Mando Diao 1 "); 

Des connexions multiples peuvent s'averer utiles si vous souhaitez effectuer plusieurs transac- 
tions a la fois, chaque connexion ne pouvant gerer qu'une seule transaction. Lorsque nous utili- 
sons les connexions de base de donnees multiples, nous pouvons toujours avoir une connexion 
non nominee qui sera exploitee par QSqlQuery si aucune connexion n'est specifiee. 

En plus de QSqlQuery, Qt fournit la classe QSqlTableModel comme interface de haut niveau, 
ce qui permet d'eviter l'emploi du code SQL brut pour realiser les operations SQL les plus 
courantes (SELECT, INSERT, UPDATE et DELETE). La classe peut etre utilisee de facon auto- 
nome pour manipuler une base de donnees sans aucune implication GUI. Elle peut egalement 
etre utilisee comme source de donnees pour QListView ou QTableView. 

Voici un exemple qui utilise QSqlTableModel pour realiser un SELECT : 

QSqlTableModel model; 

model. setTable("cd") ; 

model. setFilterf "year >= 1998"); 

model. select() ; 

Ce qui est equivalent a la requete 

SELECT * FROM cd WHERE year >= 1998 

Pour parcourir un ensemble de resultats, nous recuperons un enregistrement donne au moyen de 
QSqlTableModel : : record ( ) et nous accedons aux champs individuels a l'aide de value ( ) : 

for (int i = 0; i < model. rowCount() ; ++i) { 
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QSqlRecord record = model. record(i) ; 

QString title = record. value( "title" ) .toString() ; 

int year = record .value( "year" ) .tolntf ) ; 

cerr « qPrintable(title) « ": " « year « endl; 

} 

La fonction QSqlRecord : : value ( ) recoit soit un nom, soit un index de champ. En travaillant 
sur des jeux de donnees de taille importante, il est preferable de designer les champs par leurs 
index. Par exemple : 

int titlelndex = model. record( ) .indexOf( "title" ) ; 
int yearlndex = model. recordf ) .indexOf( "year" ) ; 
for (int i = 0; i < model. rowCount( ) ; ++i) { 

QSqlRecord record = model. record(i) ; 

QString title = record. value(titlelndex) .toString() ; 

int year = record. value(yearlndex) . tolntf) ; 

cerr « qPrintable(title) « ": " « year « endl; 

} 

Pour inserer un enregistrement dans une table de base de donnees, nous utilisons la meme 
approche que pour une insertion dans tout modele bidimensionnel : en premier lieu, nous appe- 
lons insertRow( ) pour creer une nouvelle ligne (enregistrement) vide, puis nous faisons appel a 
setData ( ) pour definir les valeurs de chaque colonne (champ). 

QSqlTableModel model; 
model. setTable("cd") ; 
int row = 0; 

model. insertRows( row, 1); 

model. setData(model.index(row, 0), 113); 

model. setData(model.index(row, 1), "Shanghai My Heart"); 

model. setData(model.index(row, 2), 224); 

model. setData(model.index(row, 3), 2003); 

model. submitAll() ; 

Apres l'appel a submitAll( ), 1' enregistrement peut etre deplace vers un emplacement diffe- 
rent dans la ligne, selon l'organisation de la table. L'appel de cette fonction retournera false 
si 1' insertion a echoue. 

Une difference importante entre un modele SQL et un modele standard est que dans le premier 
cas, nous devons appeler submitAll ( ) pour valider une modification dans la base de donnees. 

Pour mettre a jour un enregistrement, nous devons tout d'abord placer le QSqlTableModel sur 
P enregistrement a modifier (en executant select ()), par exemple. Nous extrayons ensuite 
P enregistrement, mettons a jour les champs voulus, puis reecrivons nos modifications dans la 
base de donnees : 

QSqlTableModel model; 
model. setTable("cd") ; 
model. setFilter(" id = 125"); 
model. select ( ) ; 
if (model. rowCountf) == 1 ) { 
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QSqlRecord record = model. record (0) ; 

record. setValue( "title" , "Melody A.M."); 

record. setValuefyear" , record. value( "year" ) .toInt( ) + 1); 

model. setRecord(0, record); 

model. submitAll() ; 

} 

Si un enregistrement correspond au riltre specifie, nous le recuperons au moyen de QSqlTable- 
Model : : record ( ) . Nous appliquons nos modifications et remplacons 1' enregistrement initial 
par ce dernier. 

Comme dans le cas d'un modele non SQL, il est egalement possible de realiser une mise a jour 
au moyen de setData ( ) . Les index de modele que nous recuperons correspondent a une ligne 
ou a une colonne donnee : 

model. select () ; 

if (model. rowCountf) == 1 ) { 

model. setData(model.index(0, 1), "Melody A.M. ") ; 

model. setData(model.index(0, 3), 

model. data(model.index(0, 3)).toInt() + 1); 

model. submitAll() ; 

} 

La suppression d'un enregistrement est similaire a sa mise a jour : 

model. setTable("cd") ; 
model. setFilter(" id = 125"); 
model. select () ; 
if (model. rowCountf) == 1 ) { 

model. removeRows (0, 1); 

model. submitAll() ; 

} 

Lappel de removeRows ( ) recoit le numero de ligne du premier enregistrement a supprimer 
ainsi que le nombre d'enregistrements a eliminer. Lexemple suivant supprime tous les enregis- 
trements correspondant au filtre : 

model. setTable("cd") ; 

model. setFilter( "year < 1990"); 

model. select ( ) ; 

if (model. rowCountf) > 0) { 

model. removeRows (0, model. rowCount ( ) ) ; 

model. submitAll() ; 

} 

Les classes QSqlQuery et QSqlTableModel fournissent une interface entre Qt et une base de 
donnees SQL. En utilisant ces classes, nous pouvons creer des formulaires qui presentent les 
donnees aux utilisateurs et leur permettent d'inserer, de mettre a jour et de supprimer des enre- 
gistrements. 
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Presenter les donnees sous une forme tabulaire 

Dans de nombreuses situations, il est plus simple de proposer aux utilisateurs une vue tabulaire 
d'un jeu de donnees. Dans cette section ainsi que dans la suivante, nous presentons une appli- 
cation CD Collection simple qui fait appel a QSqlTableModel et a sa sous-classe QSqlRela- 
tionalTableModel pour permettre aux utilisateurs d'afficher et d'interagir avec les donnees 
stockees dans une base de donnees. 

Le formulaire principal presente une vue maitre/detail d'un CD et les pistes du CD en cours de 
selection, comme illustre en Figure 13.1. 
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L' application utilise trois tables, definies comme suit : 

CREATE TABLE artist ( 

id INTEGER PRIMARY KEY, 
name VARCHAR(40) NOT NULL, 
country VARCHAR(40) ) ; 

CREATE TABLE cd ( 

id INTEGER PRIMARY KEY, 

title VARCHAR(40) NOT NULL, 

artistid INTEGER NOT NULL, 

year INTEGER NOT NULL, 

FOREIGN KEY (artistid) REFERENCES artist); 



CREATE TABLE track ( 

id INTEGER PRIMARY KEY, 
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title VARCHAR(40) NOT NULL, 

duration INTEGER NOT NULL, 

Cdid INTEGER NOT NULL, 

FOREIGN KEY (cdid) REFERENCES Cd); 

Certaines bases de donnees ne supportent pas les cles etrangeres. Dans ce cas, nous devons 
supprimer les clauses FOREIGN KEY. L'exemple fonctionnera toujours, mais la base de donnees 
n'appliquera pas l'integrite referentielle. (Voir Figure 13.2) 



Figure 13.2 
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Dans cette section, nous allons ecrire une boite de dialogue dans laquelle les utilisateurs pour- 
ront modifier une liste d' artistes en utilisant une forme tabulaire simple. L'utilisateur peut insu- 
rer ou supprimer des artistes au moyen des boutons du formulaire. Les mises a jour peuvent 
etre appliquees directement, simplement en modifiant le texte des cellules. Les changements 
sont appliques a la base de donnees lorsque l'utilisateur appuie sur Entree ou passe a un autre 
enregistrement. (Voir Figure 13.3) 



Figure 13.3 

La boite de dialogue 
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Voici la definition de classe pour cette boite de dialogue : 

class ArtistForm : public QDialog 
{ 

Q_0BJECT 
public: 

ArtistFormfconst QString &name, QWidget *parent 



private slots: 

void addArtist(); 
void deleteArtistl 
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void beforeInsertArtist(QSqlRecord &record); 

private: 
enum { 

Artist_Id = 0, 
Artist_Name = 1 , 
Artist_Country = 2 

}; 

QSqlTableModel *model; 
QTableView *tableView; 
QPushButton *addButton; 
QPushButton *deleteButton; 
QPushButton *closeButton; 

}; 

Le constructeur est tres similaire a celui qui serait utilise pour creer un formulaire base sur un 
modele non SQL : 

ArtistForm: :ArtistForm(const QString &name, QWidget *parent) 
: QDialog(parent) 

{ 

model = new QSqlTableModel (this) ; 
model->setTable ( " artist " ) ; 

model->setSort(Artist_Name, Qt: :AscendingOrder) ; 
model->setHeaderData(Artist_Name, Qt: :Horizontal, tr( "Name" ) ) ; 
model->setHeaderData(Artist_Country, Qt : : Horizontal, tr( "Country" ) ) ; 
model->select( ) ; 

connect (model, SIGNAL(beforeInsert(QSqlRecord &) ) , 
this, SLOT(beforeInsertArtist(QSqlRecord &))); 

tableView = new QTableView; 
tableView->setModel(model) ; 
tableView->setColumnHidden(Artist_Id, true) ; 
tableView->setSelectionBehavior(QAbstractItemView: :SelectRows) ; 
tableView->resizeColumnsToContents( ) ; 

for (int row = 0; row < model->rowCount() ; ++row) { 
QSqlRecord record = model->record(row) ; 
if (record. value(Artist_Name) .toString( ) == name) { 
tableView->selectRow(row) ; 
break; 

} 

} 



} 

Nous commencons le constructeur en creant un QSqlTableModel. Nous lui transmettons 
this comme parent pour octroyer la propriete au formulaire. Nous avons choisi de baser le tri 
sur la colonne 1 (specifiee par la constante Artist_Name), ce qui correspond au champ name. 
Si nous ne specifions pas d'en-tete de colonnes, ce sont les noms des champs qui sont utilises. 
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Nous preferons les nommer nous-memes pour garantir une casse et une internationalisation 
correctes. 

Nous creons ensuite un QTableView pour visualiser le modele. Nous masquons le champ id et 
definissons les largeurs des colonnes en fonction de leur texte afin de ne pas avoir a afficher de 
points de suspension. 

Le constructeur de ArtistForm recoit le nom de l'artiste qui doit etre selectionne a l'ouver- 
ture de la boite de dialogue. Nous parcourons les enregistrements de la table artist et selec- 
tionnons l'artiste voulu. Le reste du code du constructeur permet de creer et de connecter les 
boutons ainsi que de positionner les widgets enfants. 

void ArtistForm: :addArtist() 
{ 

int row = model->rowCount( ) ; 
model->insertRow(row) ; 

QModellndex index = model->index(row, Artist_Name) ; 
tableView->setCur rent Index (index) ; 
tableView->edit (index) ; 

} 

Pour ajouter un nouvel artiste, nous inserons une ligne vierge dans le bas de QTableView. 
Lutilisateur peut maintenant entrer le nom et le pays du nouvel artiste. S'il confirme 1' inser- 
tion en appuyant sur Entree, le signal bef orelnsert ( ) est emis puis le nouvel enregistrement 
est insere dans la base de donnees. 

void ArtistForm: :beforeInsertArtist(QSqlRecord Srecord) 
{ 

record . setValue ( " id " , generateld ( " artist " ) ) ; 

} 

Dans le constructeur, nous avons connecte le signal bef orelnsert ( ) du modele a ce slot. 
Une reference non-const a 1' enregistrement nous est transmise juste avant son insertion dans la 
base de donnees. A ce stade, nous remplissons son champ id. 

Comme nous aurons besoin de generateld ( ) a plusieurs reprises, nous la definissons "en 
ligne" dans un fichier d'en-tete et l'incluons a chaque fois que necessaire. Voici un moyen 
rapide (et inefficace) de l'implementer : 

inline int generateId(const QString Stable) 
{ 

QSqlQuery query; 

query. execfSELECT MAX(id) FROM " + table); 

int id = 0; 

if (query. next( ) ) 

id = query. value(0) .toInt() + 1; 
return id; 

} 

La fonction generateld ( ) n'est assuree de fonctionner correctement que si elle est exe- 
cutee dans le contexte de la meme transaction que l'instruction INSERT correspondante. 
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Certaines bases de donnees supportent les champs generes automatiquement, et il est generale- 
ment nettement preferable d'utiliser la prise en charge specifique a chaque base de donnees 
pour cette operation. 

La derniere possibility offerte par la boite de dialogue ArtistForm est la suppression. Au lieu 
d'effectuer des suppressions en cascade (que nous avons abordees brievement), nous avons 
choisi de n'autoriser que les suppressions d' artistes ne possedant pas de CD dans la collection. 

void ArtistForm: :deleteArtist() 
{ 

tableView->setFocus ( ) ; 

QModellndex index = tableView->currentIndex( ) ; 
if (! index. isValid()) 
return; 

QSqlRecord record = model->record ( index. row( )) ; 

QSqlTableModel cdModel; 
cdModel.setTable("cd") ; 

cdModel. setFilter( "artistid = " + record. value("id").toString()); 

cdModel. select () ; 

if (cdModel. rowCount() == 0) { 

model->removeRow(tableView->currentIndex( ) . row( ) ) ; 
} else { 

QMessageBox : : information (this , 
tr( "Delete Artist"), 

tr( "Cannot delete %1 because there are CDs associated " 

"with this artist in the collection.") 
. arg( record .value ( "name" ) .toString( ) ) ) ; 

} 

} 

Si un enregistrement est selectionne, nous determinons si 1' artiste possede un CD. Si tel n'est 
pas le cas, nous le supprimons immediatement. Sinon, nous affichons une boite de message 
expliquant pourquoi la suppression n'a pas eu lieu. Strictement parlant, nous aurions du utiliser 
une transaction, car tel que le code se presente, il est possible que 1' artiste que nous suppri- 
mons soit associe a un CD entre les appels de cdModel . select ( ) et model->removeRow( ). 
Nous presenterons une transaction dans la prochaine section. 

Implementer des formulaires maitre/detail 

A present, nous allons reviser le formulaire principal avec une approche maitre/detail. La vue 
maitre est une liste de CD. La vue detail est une liste de pistes pour le CD en cours. Ce formulaire 
represente la fenetre principale de 1' application CD Collection comme illustre en Figure 13.1. 

class MainForm : public QWidget 
{ 

Q OBJECT 
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public: 

MainForm( ) ; 



private slots: 

void addCdf) ; 

void deleteCd( ) ; 

void addTrack( ) ; 

void deleteTrack( ) ; 

void editArtistsj ) ; 

void currentCdChanged (const QModellndex &index); 

void beforeInsertCd(QSqlRecord &record); 

void beforeInsertTrack(QSqlRecord &record); 

void ref reshTrackViewHeader( ) ; 



private: 
enum { 

Cd_Id = 0, 
Cd_Title = 1, 
Cd_ArtistId = 2, 
Cd_Year = 3 

}; 

enum { 

Track_Id = 0, 
Track_Title = 1 , 
Track_Duration = 2, 
Track_CdId = 3 

}; 

QSqlRelationalTableModel *cdModel; 
QSqlTableModel *trackModel; 
QTableView *cdTableView; 
QTableView *trackTableView; 
QPushButton *addCdButton; 
QPushButton *deleteCdButton; 
QPushButton *addTrackButton; 
QPushButton *deleteTrackButton; 
QPushButton *editArtistsButton; 
QPushButton *quitButton; 

}; 

Au lieu d'un QSqlTableModel, nous utilisons un QSqlRelationalTableModel pour la table 
cd, car nous devons gerer les cles etrangeres. Nous allons maintenant revoir chaque fonction 
tour a tour, en commencant par le constructeur que nous etudierons par segments car il est 
assez long. 

MainForm: :MainForm( ) 
{ 

cdModel = new QSqlRelationalTableModel(this) ; 
cdModel->setTable( "cd" ) ; 
cdModel->setRelation(Cd_ArtistId, 

QSqlRelation( "artist" , "id", "name")); 
cdModel->setSort(Cd_Title, Qt: :AscendingOrder) ; 
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cdModel->setHeaderData(Cd_Title, Qt: :Horizontal, tr( "Title" ) ) ; 
cdModel->setHeaderData(Cd_ArtistId, Qt : : Horizontal, tr( "Artist" ) ) ; 
cdModel->setHeaderData(Cd_Year, Qt: : Horizontal, tr("Year")); 
cdModel->select() ; 

Le constructeur definit tout d'abord le QSqlRelationalTableModel qui gere la table cd. 
L'appel de setRelation ( ) indique au modele que son champ artistid (dont l'index est 
inclus dans Cd_ArtistId) possede la cle etrangere id de la table artist, et que le contenu du 
champ name correspondant doit etre affiche a la place des ID. Si l'utilisateur choisit d'editer ce 
champ (par exemple en appuyant sur F2), le modele presentera automatiquement une zone de 
liste deroulante avec les noms de tous les artistes, et si l'utilisateur choisit un artiste different, il 
mettra la table cd a jour. 

cdTableView = new QTableView; 
cdTableView->setModel(cdModel) ; 

cdTableView->setItemDelegate(new QSqlRelationalDelegate(this) ) ; 
cdTableView->setSelectionMode(QAbstractItemView: :SingleSelection) ; 
cdTableView- >setSelectionBehavior(QAbstract I temView: : Select Rows) ; 
cdTableView->setColumnHidden(Cd_Id, true) ; 
cdTableView->resizeColumnsToContents ( ) ; 

La definition de la vue pour la table cd est similaire a ce que nous avons deja vu. La seule 
difference significative est la suivante : au lieu d'utiliser le delegue par defaut de la vue, nous 
utilisons QSqlRelationalDelegate. C'est ce delegue qui gere les cles etrangeres. 

trackModel = new QSqlTableModel(this) ; 
trackModel->setTable( "track" ) ; 

trackModel->setHeaderData(Track_Title, Qt: horizontal, tr("Title")) ; 
trackModel->setHeaderData(Track_Duration, Qt: horizontal, 

tr( "Duration" ) ) ; 

trackTableView = new QTableView; 
trackTableView->setModel( trackModel) ; 
trackTableView->setItemDelegate( 

new TrackDelegate(Track_Duration, this)); 
trackTableView- >setSelectionMode( 

QAbstractltemView: :SingleSelection) ; 
trackTableView->setSelectionBehavior(QAbstractItemView: :SelectRows) ; 

Pour ce qui est des pistes, nous n'allons montrer que leurs noms et leurs durees. C'est pourquoi 
QSqlTableModel est suffisant. Le seul aspect remarquable de cette partie du code est que nous 
utilisons le TrackDelegate developpe dans le Chapitre 10 pour afficher les durees des pistes 
sous la forme "minutes: secondes" et permettre leur edition en utilisant un QTimeEdit adapte. 

La creation, la connexion et la disposition des vues ainsi que des boutons ne presente pas de 
surprise. C'est pourquoi la seule autre partie du constructeur que nous allons presenter contient 
quelques connexions non evidentes. 

connect (cdTableView->selectionModel ( ) , 
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SIGNAL(currentRowChanged(const QModellndex &, 

const QModellndex &) ) , 
this, SLOT(currentCdChanged (const QModellndex &) ) ) ; 
connect(cdModel, SIGNAL(beforeInsert(QSqlRecord &)), 

this, SLOT(beforeInsertCd(QSqlRecord &))); 
connect(trackModel, SIGNAL(beforeInsert(QSqlRecord &)), 

this, SLOT(beforeInsertTrack(QSqlRecord &))); 
connect(trackModel, SIGNAL(rowsInserted(const QModellndex &, int, 

int)), 

this, SLOTfref reshTrackviewHeader( ) ) ) ; 

} 

La premiere connexion est inhabituelle, car au lieu de connecter un widget, nous etablissons 
une connexion avec un modele de selection. La classe QltemSelectionModel est utilisee 
pour assurer le suivi des selections dans les vues. En etant connecte au modele de selection de 
la vue table, notre slot currentCdChanged ( ) sera appele des que l'utilisateur passe d'un 
enregistrement a 1' autre. 

void MainForm: :currentCdChanged(const QModellndex &index) 
{ 

if (index. isValid()) { 

QSqlRecord record = cdModel->record(index. row( ) ) ; 

int id = record. value ( "id" ) .tolntf ) ; 

trackModel->setFilter(QString( "cdid = %1 " ) .arg(id) ) ; 
} else { 

trackModel->setFilter( "cdid = -1"); 

} 

trackModel->select ( ) ; 
ref reshTrackViewHeader( ) ; 

} 

Ce slot est appele des que le CD en cours change, ce qui se produit lorsque l'utilisateur passe a 
un autre CD (en cliquant ou en utilisant les touches flechees). Si le CD est invalide (s'il 
n'existe pas de CD, si un nouveau CD est en cours d'insertion ou encore si celui en cours vient 
d'etre supprime), nous definissons le cdid de la table track en 1 (un ID invalide qui ne 
correspondra a aucun enregistrement). 

Puis, en ayant derini le nitre, nous selectionnons les enregistrements de piste correspondants. 
La fonction ref reshTrackViewHeader ( ) sera etudiee dans un moment. 

void MainForm: :addCd() 
{ 

int row = 0; 

if (cdTableView->currentIndex( ) .isValid()) 
row = cdTableView->currentIndex( ) . row( ) ; 

cdModel->insertRow(row) ; 

cdModel->setData(cdModel->index(row, Cd_Year) , 
QDate: :currentDate() .year() ) ; 
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QModellndex index = cdModel->index(row, Cd_Title); 
cdTableView->setCurrent Index (index) ; 
cdTableView->edit (index) ; 

} 

Lorsque l'utilisateur clique sur le bouton Add CD, une nouvelle ligne vierge est inseree dans le 
cdTableView et nous entrons en mode edition. Nous definissons egalement une valeur par 
defaut pour le champ year. A ce stade, l'utilisateur peut modifier l'enregistrement en remplis- 
sant les champs vierges et en selectionnant un artiste dans la zone de liste deroulante qui est 
automatiquement fournie par le QSqlRelationalTableModel grace a l'appel de setRela- 
tion(). II peut aussi modifier 1 ' annee si celle proposee par defaut s ' avere inappropriee . 
Si l'utilisateur confirme l'insertion en appuyant sur Entree, l'enregistrement est insere. L'utili- 
sateur peut annuler en appuyant sur Echap. 

void MainForm: :beforeInsertCd(QSqlRecord Srecord) 
{ 

record .setValuef "id" , generateldf "cd" ) ) ; 

} 

Ce slot est appele lorsque le cdModel emet son signal bef orelnsert ( ). Nous l'utilisons pour 
remplir le champ id de la meme facon que nous l'avons fait pour inserer de nouveaux artistes. 
Les memes regies s'appliquent : cette operation doit s'effectuer dans la portee d'une transac- 
tion et avec les methodes de creation d'lD specifiques a la base de donnees (par exemple, les 
ID generes automatiquement). 

void MainForm: :deleteCd( ) 
{ 

QModellndex index = cdTableView->currentIndex( ) ; 
if (! index. isValid()) 
return; 

QSqlDatabase db = QSqlDatabase: :database() ; 
db.transaction( ) ; 

QSqlRecord record = cdModel->record(index.row()) ; 
int id = record. value(Cd_Id) .toInt() ; 
int tracks = 0; 
QSqlQuery query; 

query. exec(QString( "SELECT C0UNT(*) FROM track WHERE cdid = %1 " ) 

.arg(id)); 
if (query. next( ) ) 

tracks = query. value(0) .toInt() ; 
if (tracks > 0) { 

int r = QMessageBox: :question(this, tr("Delete CD"), 

tr( "Delete and all its tracks?") 

. arg( record. value (Cd_Artist Id) .toString( ) ) , 
QMessageBox: :Yes | QMessageBox: : Default, 
QMessageBox: : No | QMessageBox: : Escape) ; 
if (r == QMessageBox: : No) { 
db. rollback( ) ; 
return; 

} 
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query. exec(QString("DELETE FROM track WHERE cdid = %1") 
■arg(id)); 

} 

cdModel- >removeRow( index. row ( ) ) ; 
cdModel->submitAll( ) ; 
db. commit ( ) ; 

currentCdChanged(QModelIndex( ) ) ; 

} 

Lorsque l'utilisateur clique sur le bouton Delete CD, ce slot est appele. Quand un CD est en 
cours, nous determinons son nombre de pistes. Si nous ne trouvons pas de piste, nous suppri- 
mons directement l'enregistrement du CD. S'il existe au moins une piste, nous demandons a 
l'utilisateur de confirmer la suppression. S'il clique sur Yes, nous supprimons tous les enregis- 
trements de piste, puis l'enregistrement du CD. Toutes ces operations sont effectuees dans la 
portee d'une transaction. Ainsi, soit la suppression en cascade echoue en bloc, soit elle reussit 
dans son ensemble - en supposant que la base de donnees en question supporte les transactions. 

La gestion des donnees de piste est tres similaire a celle des donnees de CD. Les mises a jour 
peuvent etre effectuees simplement via les cellules d'edition fournies a l'utilisateur. Dans le 
cas des durees de piste, notre TrackDelegate s'assure qu'elles sont presentees dans le bon 
format et qu'elles sont facilement modifiables au moyen deQTimeEdit. 

void MainForm: :addTrack( ) 
{ 

if ( !cdTableView->currentIndex( ) .isValid() ) 
return; 

int row = 0; 

if (trackTableView->currentIndex( ) .isValidf) ) 
row = trackTableView->currentIndex( ) . row( ) ; 

trackModel->insertRow(row) ; 

QModellndex index = trackModel->index(row, Track_Title) ; 
trackTableView->setCurrentIndex( index) ; 
trackTableView->edit(index) ; 

} 

Le fonctionnement ici est le meme que celui de addCd ( ) , avec une nouvelle ligne vierge inseree 
dans la vue. 

void MainForm: :beforeInsertTrack(QSqlRecord &record) 
{ 

QSqlRecord cdRecord = cdModel->record(cdTableView->currentIndex( ) 

.row()); 

record. setValuef" id", generateld( "track" ) ) ; 

record. setValue(" cdid" , cdRecord. value(Cd_Id) .tolntf) ) ; 

} 
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Si l'utilisateur confirme l'insertion initiee par addTrack(), cette fonction est appelee pour 
remplir les champs id et cdid. Les regies mentionnees precedemment s'appliquent bien stir 
toujours ici. 

void MainForm: :deleteTrack( ) 
{ 

trackModel->removeRow(trackTableView->currentIndex( ) . row( ) ) ; 
if (trackModel->rowCount( ) == 0) 

trackTableView->horizontalHeader( ) ->setVisible(false) ; 

} 

Si l'utilisateur clique sur le bouton Delete Track, nous supprimons la piste sans formalite. 
II serait facile d'afficher une boite de message de type Yes/No si nous envisagions de faire 
confirmer les suppressions. 

void MainForm: : ref reshTrackViewHeaderf ) 
{ 

trackTableView->horizontalHeader( )->setVisible( 

trackModel->rowCount() > 0); 
trackTableView->setColumnHidden(Track_Id, true) ; 
trackTableView->setColumnHidden(Track_CdId, true) ; 
trackTableView->resizeColumnsToContents( ) ; 

} 

Le slot ref reshTrackViewHeader ( ) est invoque depuis plusieurs emplacements pour 
s'assurer que l'en-tete horizontal de la vue de piste n'est presente que s'il existe des pistes a 
afficher. II masque aussi les champs id et cdid et redimensionne les colonnes de table visibles 
en fonction du contenu courant de la table. 

void MainForm: :editArtists() 
{ 

QSqlRecord record = cdModel->record(cdTableView->currentIndex( ) 

■row()); 

ArtistForm artistForm(record. value(Cd_ArtistId) .toStringf) , this) ; 
artistForm.execf) ; 
cdModel->select() ; 

} 

Ce slot est appele si l'utilisateur clique sur le bouton Edit Artists. II affiche les donnees 
concernant l'artiste du CD en cours, invoquant le ArtistForm traite dans la section precedente 
et selectionnant l'artiste approprie. S'il n'existe pas d'enregistrement en cours, un enregistre- 
ment vide est retourne par record ( ). II ne correspond naturellement a aucun artiste dans le 
formulaire. Voici ce qui se produit veritablement : comme nous utilisons un QSqlRelational- 
TableModel qui etablit une correspondance entre les ID des artistes et leurs noms, la valeur 
qui est retournee lorsque nous appelons record . value (Cd_ArtistId ) est le nom de l'artiste 
(qui sera une chaine vide si l'enregistrement est vide). Nous forcons enfin le cdModel a selec- 
tionner de nouveau ses donnees, ce qui conduit le cdTableView a rafraichir ses cellules visibles. 
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Cette operation permet de s' assurer que les noms des artistes sont affiches correctement, 
certains d'entre eux ayant pu etre modifies par l'utilisateur dans la boite de dialogue Artist- 
Form. 

Pour les projets qui utilisent les classes SQL, nous devons ajouter la ligne 
QT += sql 

aux richiers . pro, ce qui garantit la liaison de 1' application a la bibliotheque QtSql. 

Ce chapitre vous a demontre que les classes vue/modele de Qt facilitent autant que possible 
l'affichage et la modification de donnees dans les bases SQL. Dans les cas ou les cles etrangeres 
se referent a des tables comportant de nombreux enregistrements (des milliers, voir plus), il est 
probablement preferable de creer votre propre delegue et de l'utiliser pour presenter un formu- 
laire de "listes de valeurs" offrant des possibilites de recherche au lieu de vous reposer sur les 
zones de liste deroulante par defaut de QSqlRelationalTableModel. Et si nous souhaitons 
presenter des enregistrements en utilisant un mode formulaire, nous devons le gerer par nous- 
memes : en faisant appel a un QSqlQuery ou a un QSqlTableModel pour gerer l'interaction 
avec la base de donnees, et en etablissant une correspondance entre le contenu des widgets de 
1' interface utilisateur que nous souhaitons utiliser pour presenter et modifier les donnees et la 
base de donnees concernee dans notre propre code. 
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Au sommaire de ce chapitre 

V Programmer les clients FTP 

t/ Programmer les clients HTTP 

Programmer les applications 
client/serveur TCP 

»/ Envoyer et recevoir des data- 
grammes UDP 



Qt fournit les classes QFtp et QHttp pour la programmation de FTP et HTTP. Ces 
protocoles sont faciles a utiliser pour telecharger des fichiers et, dans le cas de HTTP, 
pour envoyer des requetes aux serveurs Web et recuperer les resultats. 

Qt fournit egalement les classes de bas niveau QTcpSocket et QUdpSocket, qui imple- 
mentent les protocoles de transport TCP et UDP. TCP est un protocole oriente 
connexion fiable qui agit en termes de flux de donnees transmis entre les noeuds reseau, 
alors que UDP est un protocole fonctionnant en mode non connecte non fiable qui 
permet d'envoyer des paquets discrets entre des noeuds reseau. Tous deux peuvent etre 
utilises pour creer des applications reseau clientes et serveur. En ce qui concerne les 
serveurs, nous avons aussi besoin de la classe QTcpServer pour gerer les connexions 
TCP entrantes. 
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Programmer les clients FTP 

La classe QFtp implemente le cote client du protocole FTP dans Qt. Elle offre diverses fonc- 
tions destinees a realiser les operations FTP les plus courantes et nous permet d'executer des 
commandes FTP arbitraires. 

La classe QFtp fonctionne de facon asynchrone. Lorsque nous appelons une fonction telle que 
get() ouput(), elle se termine immediatement et le transfert de donnees se produit quand le 
controle revient a la boucle d'evenement de Qt. Ainsi, l'interface utilisateur reste reactive 
pendant 1' execution des commandes FTP. 

Nous allons commencer par un exemple qui illustre comment recuperer un fichier unique au 
moyen de get ( ) . Lexemple est une application de console nominee f tpget qui telecharge le 
fichier distant specifie sur la ligne de commande. Commencons par la fonction main ( ) : 

int mainfint argc, char *argv[]) 
{ 

QCoreApplication appfargc, argv) ; 
QStringList args = app. arguments)) ; 

if (args.count( ) != 2) { 

cerr « "Usage: ftpget url" « endl 
« "Example: " « endl 

« " ftpget ftp://ftp.trolltech.com/mirrors" « endl; 
return 1 ; 

} 

FtpGet getter; 

if (! getter. getFile(QUrl(args[ 1 ] ) ) ) 
return 1 ; 

QObject: :connect(&getter, SIGNAL(done( ) ) , &app, SL0T(quit( ) ) ) ; 
return app.exec() ; 

} 

Nous creons un QCoreApplication plutot que sa sous-classe QApplication pour eviter une 
liaison dans la bibliotheque QtGui. La fonction QCoreApplication : : arguments ( ) retourne 
les arguments de ligne de commande sous forme de QStringList, le premier element etant le 
nom sous lequel le programme a ete invoque, et tous les arguments propres a Qt (tels que - style) 
etant supprimes. Le coeur de la fonction main() est la construction de l'objet FtpGet et 
l'appel de getFile(). Si l'appel reussit, nous laissons la boucle d'evenement s'executer 
jusqu'a la fin du telechargement. 

Tout le travail est effectue par la sous-classe FtpGet, qui est definie comme suit : 

class FtpGet : public QObject 
{ 

Q OBJECT 
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public: 

FtpGet(QObject *parent = 0); 

bool getFile(const QUrl &url); 

signals: 

void done( ) ; 

private slots: 

void ftpDonefbool error); 

private: 
QFtp ftp; 
QFile file; 

}; 

La classe possede une fonction publique, getFile( ), qui recupere le fichier specifie par une 
URL. La classe QUrl fournit une interface de haut niveau destinee a extraire les differents 
segments d'une URL, tels que le nom du fichier, le chemin d'acces, le protocole et le port. 

FtpGet possede un slot prive, ftpDone(), qui est appele lorsque le transfert de fichier est 
termine, et un signal done() qui est emis une fois le fichier telecharge. La classe contient 
egalement deux variables privees : la variable ftp, de type QFtp, qui encapsule la connexion 
avec un serveur FTP et la variable file qui est utilisee pour ecrire le fichier telecharge sur le 
disque. 

FtpGet: : FtpGet (QObject *parent) 
: QObject(parent) 

{ 

connect(&ftp, SIGNAL(done(bool) ) , this, SLOT(ftpDone(bool) ) ) ; 

} 

Dans le constructeur, nous connectons le signal QFtp: :done(bool) a notre slot prive 
f tpDone(bool). QFtp emet done(bool) une fois le traitement de toutes les requetes termine. 
Le parametre bool indique si une erreur s'est produite ou non. 

bool FtpGet: :getFile(const QUrl &url) 
{ 

if (Iurl.isValid()) { 

cerr « "Error: Invalid URL" « endl; 
return false; 

} 

if (url. schemed != "ftp") { 

cerr « "Error: URL must start with 'ftp:'" « endl; 
return false; 

} 

if (url.path() .isEmptyO) { 

cerr « "Error: URL has no path" « endl; 
return false; 

} 
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QString localFileName = QFileInfo(url.path() ) .fileName() ; 
if (localFileName. isEmptyf ) ) 
localFileName = "ftpget.out"; 

file . setFileName( localFileName) ; 

if ( !file.open(QIODevice: :WriteOnly) ) { 

cerr « "Error: Cannot open " « qPrintable(file.fileName()) 
« " for writing: " « qPrintable(file.errorString()) 
« endl; 
return false; 

} 

ftp.connectToHost (url.host ( ) , url.port (21 ) ) ; 
ftp. login () ; 

ftp.get(url.path(), &file); 
ftp. close( ) ; 
return true; 

} 

La fonction getFile ( ) commence en verifiant l'URL transmise. Si un probleme est rencontre, 
elle emet un message d'erreur vers cerr et retourne false pour indiquer que le telechargement a 
echoue. 

Au lieu d'obliger l'utilisateur a creer un nom de fichier local, nous essayons de generer un nom 
judicieux constitue de l'URL elle-meme, avec ftpget.out comme solution de secours. Si 
nous ne parvenons pas a ouvrir le fichier, nous affichons un message d'erreur et retournons 
false. 

Nous executons ensuite une sequence de quatre commandes FTP en utilisant notre objet QFtp. 
L'appel de url . port (21 ) retourne le numero de port mentionne dans l'URL, ou le port 21 si 
l'URL n'en specifie aucun. Aucun nom d'utilisateur ou mot de passe n'etant transmis a la 
fonction login ( ) , on tente une ouverture de session anonyme. Le second argument de get ( ) 
specifie le peripherique de sortie. 

Les commandes FTP sont placees en file d'attente et executees dans la boucle d'evenement de 
Qt. L'achevement de toutes les commandes est indique par le signal done ( bool ) de QFtp, que 
nous avons connecte aftpDone(bool) dans le constructeur. 

void FtpGet: :ftpDone(bool error) 
{ 

if (error) { 

cerr « "Error: " « qPrintable(ftp.errorString() ) « endl; 
} else { 

cerr « "File downloaded as " « qPrintable(file.fileName()) 
« endl; 

} 

file. close() ; 
emit done( ) ; 

} 
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Les commandes FTP ayant toutes ete executees, nous fermons le fichier et emettons notre 
propre signal done ( ) . II peut sembler etrange de fermer le fichier ici, et non apres l'appel de 
ftp . close () a la fin de la fonction get_File( ), mais souvenez-vous que les commandes FTP 
sont executees de facon asynchrone et peuvent tres bien etre en cours a la fin de 1' execution de 
getFile( ). Seule remission du signal done( ) de l'objet QFtp nous permet de savoir que le 
telechargement est termine et que le fichier peut etre ferme en toute securite. 

QFtp fournit plusieurs commandes FTP, dont connectToHost ( ), login (), close (), 
list ( ), cd( ), get ( ), put ( ), remove ( ), mkdir( ), rmdir( ) et rename ( ). Toutes ces fonc- 
tions programment une commande FTP et retournent un numero dTD qui identifie cette 
commande. II est egalement possible de controler le mode et le type de transfert (l'option par 
defaut est un mode passif et un type binaire). 

Les commandes FTP arbitraires peuvent etre executees au moyen de la commande rawCom- 
mand (). Voici, par exemple, comment executer une commande SITE CHMOD : 

ftp. raw/Command ( "SITE CHMOD 755 fortune"); 

QFtp emet le signal commandStarted ( int ) quand il commence a executer une commande 
et le signal commandFinished ( int , bool) une fois la commande terminee. Le parametre 
int est le numero dTD qui identifie la commande. Si nous nous interessons au sort des 
commandes individuelles, nous pouvons stacker les numeros dTD lors de la programmation 
des commandes. Le fait de suivre ces numeros nous permet de fournir un rapport detaille a 
l'utilisateur. Par exemple : 

bool FtpGet: :getFile(const QUrl &url) 
{ 

connectld = ftp.connectToHost(url.host(), url. port (21 ) ) ; 

loginld = ftp.login() ; 

getld = ftp.get(url.path() , &file); 

closeld = ftp. closed ; 

return true; 

} 

void FtpGet: :ftpCommandStarted(int id) 
{ 

if (id == connectld) { 

cerr « "Connecting..." « endl; 
} else if (id == loginld) { 

cerr « "Logging in..." « endl; 

} 

Un autre moyen de fournir un rapport consiste a etablir une connexion au signal stateChanged ( ) 
de QFtp, qui est emis lorsque la connexion entre dans un nouvel etat (QFtp: : Connecting, 
QFtp: :Connected, QFtp: :LoggedIn, etc.) 
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Dans la plupart des applications, nous nous interessons plus au sort de la sequence de 
commandes dans son ensemble qu'aux commandes particulieres. Dans ce cas, nous pouvons 
simplement nous connecter au signal done(bool), qui est emis des que la file d'attente de 
commandes est vide. 

Quand une erreur se produit, QFtp vide automatiquement la file d'attente de commandes. 
Ainsi, si la connexion ou l'ouverture de session echoue, les commandes qui suivent dans la file 
d'attente ne sont jamais executees. Si nous programmons de nouvelles commandes au moyen 
de l'objet QFtp apres que l'erreur se soit produite, elles sont placees en file d'attente et executees. 

Dans le fichier .pro de 1' application, la ligne suivante est necessaire pour etablir une liaison 
avec la bibliotheque QtNetwork : 

QT += network 

Nous allons maintenant etudier un exemple plus sophistique. Le programme de ligne de 
commande spicier telecharge tous les fichiers situes dans un repertoire FTP. La logique reseau 
est geree dans la classe Spider : 

class Spicier : public QObject 
{ 

Q_0BJECT 
public: 

Spider(QObject *parent = 0); 

bool getDirectory (const QUrl &url); 

signals: 

void done() ; 

private slots: 

void ftpDone(bool error); 

void ftpListlnfofconst QUrllnfo &urlInfo); 

private: 

void processNextDirectoryf ) ; 
QFtp ftp; 

QList<QFile *> openedFiles; 
QString currentDir; 
QString currentLocalDir; 
QStringList pendingDirs; 

}; 

Le repertoire de depart est specifie en tant que QUrl et est defini au moyen de la fonction 
getDirectory ( ). 

Spider: :Spider(QObject *parent) 
: QObject(parent) 

{ 
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connect(&ftp, SIGNAL(done(bool) ) , this, SLOT(ftpDone(bool) ) ) ; 
connect(&ftp, SIGNAL(listInfo(const QUrllnfo &)), 
this, SLOT(ftpListInfo(const QUrllnfo &))); 

} 

Dans le constructeur, nous etablissons deux connexions signal/slot. Le signal list Info 
(const QUrllnfo &) est emis par QFtp lorsque nous demandons un listing de repertoires 
(dans getDirectory ( )) pour chaque fichier recupere. Ce signal est connecte a un slot nomme 
f tpListlnf o ( ), qui telecharge le fichier associe a 1'URL qui lui est fournie. 

bool Spider: :getDirectory (const QUrl &url) 
{ 

if (Iurl.isValid()) { 

cerr « "Error: Invalid URL" « endl; 
return false; 

} 

if (url. schemed != "ftp") { 

cerr « "Error: URL must start with 'ftp:'" « endl; 
return false; 

} 

ftp.connectToHost (url.host ( ) , url.port (21 ) ) ; 
ftp.login() ; 

QString path = url.path(); 
if (path.isEmptyO) 
path = "/"; 

pendingDirs.append(path) ; 
processNextDirectory() ; 

return true; 

} 

Lorsque la fonction getDirectory ( ) est appelee, elle commence par effectuer quelques veri- 
fications de base, et, si tout va bien, tente d'etablir une connexion FTP. Elle appelle process- 
NextDirectory() pour lancer le telechargement du repertoire racine. 

void Spider: :processNextDirectory() 
{ 

if (!pendingDirs.isEmpty()) { 

currentDir = pendingDirs.takeFirst() ; 
currentLocalDir = "downloads/" + currentDir; 
QDir( " . " ) . mkpath (currentLocalDir) ; 

ftp.cd(currentDir) ; 
ftp.list(); 
} else { 

emit done( ) ; 

} 

} 
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La fonction processNextDirectory ( ) recoit le premier repertoire distant provenant de la 
liste pendingDirs et cree un repertoire correspondant dans le systeme de fichiers local. 
Elle indique ensuite a l'objet QFtp de remplacer le repertoire existant par celui recu et de 
repertorier ses fichiers. Pour tout fichier traite par list ( ), un signal listlnf o( ) provoquant 
l'appel du slot f tpListlnf o( ) est emis. 

S'il ne reste plus de repertoire a traiter, la fonction emet le signal done ( ) pour indiquer que le 
telechargement est acheve. 

void Spider: :ftpListInfo(const QUrllnfo Surllnfo) 
{ 

if (urllnfo.isFileO) { 

if (urllnfo.isReadablef ) ) { 

QFile *file = new QFile(currentLocalDir + "/" 

+ urlInfo.name( ) ) ; 

if ( !f ile->open(QIODevice: :WriteOnly) ) { 
cerr « "Warning: Cannot open file " 
« qPrintable( 

QDir: :convertSeparators(file->fileName() ) ) 
« endl; 
return; 

} 

ftp.get(urlInfo.name() , file); 
openedFiles.append(file) ; 

} 

} else if (urlInfo.isDir() && !urlInfo.isSymLink( ) ) { 

pendingDirs. append(currentDir + "/" + u rl Info. name ( ) ) ; 

} 

} 

Le parametre urllnf o du slot f tpListlnf o ( ) fournit des informations detaillees concernant 
un fichier distant. S'il s'agit d'un fichier normal (et non d'un repertoire) lisible, nous appelons 
get ( ) pour le telecharger. L'objet QFile utilise pour le telechargement est alloue au moyen de 
new et un pointeur dirige vers celui-ci est stocke dans la liste openedFiles. 

Si le QUrllnfo contient les details d'un repertoire distant qui n'est pas un lien symbolique, 
nous ajoutons ce repertoire a la liste pendingDirs. Nous ignorons les liens symboliques car 
ils peuvent aisement mener a une recurrence infinie. 

void Spider: :ftpDone(bool error) 
{ 

if (error) { 

cerr « "Error: " « qPrintable(ftp.errorString() ) « endl; 
} else { 

cout « "Downloaded " « qPrintable(currentDir) « " to " 
« qPrintable(QDir: :convertSeparators( 

QDir(currentLocalDir) .canonicalPath() ) ) ; 

} 
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qDeleteAll(openedFiles) ; 
openedFiles.clear() ; 

processNextDirectory( ) ; 

} 

Le slot ftpDone() est appele lorsque toutes les commandes FTP sont terminees ou si une 
erreur se produit. Nous supprimons les objets QFile pour eviter les fuites de memoire et egale- 
ment pour fermer chaque fichier. Nous appelons enfin processNextDirectory(). S'il reste 
des repertoires, tout le processus recommence pour le repertoire suivant dans la liste. Dans le 
cas contraire, le telechargement est interrompu une fois done ( ) emis. 

Si aucune erreur n'intervient, la sequence de signaux et de commandes FTP est la suivante : 

connectToHostfhost, port) 
login () 

cd(directory_1 ) 
list() 

emit listInfo(file_1_1 ) 

get(file_1_1) 
emit listInfo(file_1_2) 

get(file_1_2) 

emit done() 



cd(directory_N) 
list() 

emit listInfo(file_N_1 ) 

get(file_N_1) 
emit listInfo(file_N_2) 

get(file_N_2) 

emit done() 

Si un fichier est un repertoire, il est ajoute a la liste pendingDirs. Une fois le dernier fichier 
de la commande list() telecharge, une nouvelle commande cd() est emise, suivie d'une 
commande list ( ) avec le repertoire suivant en attente. Tout le processus recommence alors 
avec ce repertoire. Ces operations sont repetees jusqu'a ce que chaque fichier ait ete telecharge. 
A ce moment la, la liste pendingDirs est vide. 

Si une erreur reseau se produit lors du telechargement du cinquieme ou, disons, du vingtieme 
fichier d'un repertoire, les fichiers restants ne sont pas telecharges. Pour telecharger autant de 
fichiers que possible, une solution consisterait a planifier les operations GET une par une et a 
attendre le signal done(bool) avant la planification de l'operation suivante. Dans 
listInfo(), nous accolerions simplement le nom de fichier a un QStringList au lieu 
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d'appeler get() directement, et dans done(bool) nous appellerions get() sur le fichier 
suivant a telecharger dans le QStringList. La sequence d'execution serait alors celle-ci : 

connectToHost(host, port) 
login () 

cd(directory_1 ) 
list() 

cd(directory_N) 
list() 

emit listInfo(file_1_1 ) 
emit listInfo(file_1_2) 

emit listInfo(file_N_1 ) 
emit listInfo(file_N_2) 

emit done() 

get(file_1_1) 
emit done() 

get(file_1_2) 
emit done() 



get(file_N_1) 
emit done() 

get(file_N_2) 
emit done() 



Une autre solution consisterait a utiliser un objet QFtp pour chaque fichier, ce qui nous permettrait 
de telecharger les fichiers en parallele, par le biais de connexions FTP separees. 

int mainfint argc, char *argv[]) 
{ 

QCoreApplication appfargc, argv) ; 
QStringList args = app. arguments)) ; 

if (args.count( ) != 2) { 

cerr « "Usage: spider url" « endl 
« "Example: " « endl 

« " spider ftp://ftp.trolltech.com/freebies/leafnode" 
« endl; 
return 1 ; 

} 
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Spicier spider; 

if ( ! spider. getDirectory(QUrl(args[1 ] ) ) ) 
return 1 ; 

QObject: :connect(&spider, SIGNAL(done( ) ) , &app, SL0T(quit() ) ) ; 
return app.exec() ; 

} 

La fonction main ( ) acheve le programme. Si l'utilisateur ne specifie pas d'URL sur la ligne de 
commande, nous generons un message d'erreur et terminons le programme. 

Dans les deux exemples FTP, les donnees recuperees au moyen de get ( ) ont ete ecrites dans 
un QFile. Ceci n'est pas obligatoire. Si nous souhaitions enregistrer les donnees en memoire, 
nous pourrions utiliser un QBuf f er, la sous-classe QIODevice qui integre un QByteArray. 
Par exemple : 

QBuffer *buffer = new QBuffer; 
buffer->open(QIODevice: :WriteOnly) ; 
ftp.get(urlInfo.name() , buffer); 

Nous pourrions egalement omettre l'argument de peripherique d'E/S de get ( ) ou transmettre 
un pointeur nul. La classe QFtp emet alors un signal readyRead() des qu'une nouvelle 
donnee est disponible. Cette derniere est ensuite lue au moyen de read ( ) ou de readAll ( ) . 

Programmer les clients HTTP 

La classe QHttp implemente le cote client du protocole HTTP dans Qt. Elle fournit diverses 
fonctions destinees a effectuer les operations HTTP les plus courantes dont get ( ) et post ( ), 
et permet d'envoyer des requetes HTTP arbitraires. Si vous avez lu la section precedente 
concernant QFtp, vous constaterez qu'il existe des similitudes entre QFtp et QHttp. 

La classe QHttp fonctionne de facon asynchrone. Lorsque nous appelons une fonction telle 
que get ( ) ou post ( ), elle se termine immediatement et le transfert de donnees se produit 
ulterieurement quand le controle revient a la boucle d'evenement de Qt. Ainsi, l'interface utili- 
sateur de 1' application reste reactive pendant le traitement des requetes HTTP. 

Nous allons etudier un exemple d'application de console nommee httpget qui illustre 
comment telecharger un fichier en utilisant le protocole HTTP. II est tres similaire a l'exemple 
f tpget de la section precedente, a la fois en matiere de fonctionnalite et d'implementation. 
Nous ne presenterons done pas le fichier d'en-tete. 

HttpGet: :HttpGet (QObject *parent) 
: QObject(parent) 

{ 

connect(&http, SIGNAL(done(bool) ) , this, SLOT(httpDone(bool) ) ) ; 

} 
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Dans le constructeur, nous connectons le signal done(bool) de l'objet QHttp au slot prive 
httpDone(bool). 

bool HttpGet: :getFile(const QUrl &url) 
{ 

if (lurl.isValid()) { 

cerr « "Error: Invalid URL" « endl; 
return false; 

} 

if (url. schemed != "http") { 

cerr « "Error: URL must start with 'http:'" « endl; 
return false; 

} 

if (url.path() .isEmptyO) { 

cerr « "Error: URL has no path" « endl; 
return false; 

} 

QString localFileName = QFileInfo(url.path() ) .fileNamef) ; 
if (localFileName. isEmpty( ) ) 

localFileName = "httpget .out" ; 

file . set FileNamef localFileName) ; 

if ( !file.open(QIODevice: :WriteOnly) ) { 

cerr « "Error: Cannot open " « qPrintableffile. fileNamef)) 
« " for writing: " « qPrintable(file.errorString()) 
« endl; 
return false; 

} 

http. setHost(url. host () , url.port(80) ) ; 
http.get(url.path() , &file); 
http.closef) ; 
return true; 

} 

La fonction getFile ( ) effectue le meme type de controle d'erreur que la fonction FtpGet : : 
get File ( ) presentee precedemment et utilise la meme approche pour attribuer au fichier un 
nom local. Lors d'une recuperation depuis un site Web, aucun nom de connexion n'est neces- 
saire. Nous definissons simplement l'hote et le port (en utilisant le port HTTP 80 par defaut s'il 
n'est pas specirie dans l'URL) et telechargeons les donnees dans le fichier, puisque le 
deuxieme argument de QHttp : : get ( ) specifie le peripherique d'E/S. 

Les requetes HTTP sont placees en file d'attente et executees de fagon asynchrone dans la 
boucle d'evenement de Qt. Lachevement des requetes est indique par le signal done (bool) 
de QHttp, que nous avons connecte a httpDone(bool) dans le constructeur. 

void HttpGet: :httpDone( bool error) 
{ 



Chapitre 14 



Gestion de reseau 341 



if (error) { 

cerr « "Error: " « qPrintable(http.errorString( ) ) « endl; 
} else { 

cerr « "File downloaded as " « qPrintable(file.fileName()) 
« endl; 

} 

file. close)) ; 
emit done( ) ; 

} 

Une fois les requetes HTTP terminees, nous fermons le fichier, en avertissant l'utilisateur si 
une erreur s'est produite. 

La fonction main ( ) est tres similaire a celle utilisee par f tpget : 

int mainfint argc, char *argv[]) 
{ 

QCoreApplication appfargc, argv) ; 
QStringList args = app. arguments () ; 

if (args.count( ) != 2) { 

cerr « "Usage: httpget url" « endl 
« "Example: " « endl 

« " httpget http://doc.trolltech.com/qq/index.html" 
« endl; 
return 1 ; 

} 

HttpGet getter; 

if (! getter. getFile(QUrl(args[ 1 ] ) ) ) 
return 1 ; 

QObject: :connect(&getter, SIGNAL(done( ) ) , &app, SLOT(quitf) ) ) ; 
return app.execf) ; 

} 

La classe QHttp fournit de nombreuses operations, dont setHost(), get(), post() et 
head( ). Si un site requiert une authentification, setUser( ) sera utilise pour fournir un nom 
d'utilisateur et un mot de passe. QHttp peut utiliser un socket transmis par le programmeur au 
lieu de son QTcpSocket interne, ce qui autorise l'emploi d'un QtSslSocket securise, fourni 
en tant que Qt Solution par Trolltech. 

Pour envoyer une liste de paires "nom=valeur" a un script CGI, nous faisons appel a post ( ) : 
http.setHost("www.example.com" ) ; 

http.post ( " /cgi/somescript .py" , "x=200&y=320" , &file); 

Nous pouvons transmettre les donnees soit sous la forme d'une chaine de 8 octets, soit en 
transmettant un QIODevice ouvert, tel qu'un QFile. Pour plus de controle, il est possible de 
recourir a la fonction request ( ), qui accepte des donnees et un en-tete HTTP arbitraire. 
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Par exemple : 

QHttpRequestHeader header ( "POST" , " /search. html" ) ; 

header. setValue( "Host" , "www.trolltech.com" ) ; 

header. setContentType( "application /x-www-form-u rlencoded" ) ; 

http.setHost("www.trolltech.com" ) ; 

http. request (header, "qt-interest=on&search=opengl" ) ; 

QHttp emet le signal requestStarted ( int ) quand il commence a executer une requete, puis 
le signal requestFinished(int, bool) une fois la commande terminee. Le parametre int 
est le numero d'ID qui identifie une requete. Si nous nous interessons au sort des requetes indi- 
viduelles, nous pouvons stacker les numeros d'ID lors de la programmation de ces dernieres. 
Le suivi de ces identifiants nous permet de fournir un rapport detaille a l'utilisateur. 

Dans la plupart des applications, nous souhaitons simplement savoir si la sequence de requetes 
dans son ensemble s'est terminee avec succes ou non. Dans ce cas, nous etablissons une 
connexion au signal done ( ) , qui est emis lorsque la file d'attente de la requete est vide. 

Quand une erreur se produit, la file d'attente de la requete est videe automatiquement. Si nous 
programmons de nouvelles requetes au moyen de l'objet QHttp apres que l'erreur s'est 
produite, elles sont placees en file d'attente et envoy ees. 

Comme QFtp, QHttp fournit un signal readyRead() ainsi que les fonctions read() et 
readAll ( ) , dont l'emploi evite la specification d'un peripherique d'E/S. 

Programmer les applications client/serveurTCP 

Les classes QTcpSocket et QTcpServer peuvent etre utilisees pour implementer des serveurs 
et des clients TCP. TCP est un protocole de transport sur lequel sont bases la plupart des proto- 
coles Internet de niveau application, y compris FTP et HTTP. En outre, il est susceptible d'etre 
utilise pour les protocoles personnalises. 

TCP est un protocole oriente flux. Pour les applications, les donnees apparaissent sous la forme 
d'un long flux, plutot que sous la forme d'un gros fichier plat. Les protocoles de haut niveau 
bases sur TCP sont generalement orientes ligne ou bloc : 

• Les protocoles orientes ligne transferent les donnees sous la forme de lignes de texte, 
chacune etant terminee par un retour a la ligne. 

• Les protocoles orientes bloc transferent les donnee sous la forme de blocs de donnees 
binaires. Chaque bloc comprend un champ de taille suivi de la quantite de donnees specifiee. 

QTcpSocket herite de QIODevice par le biais de QAbstractSocket. II peut done etre lu et 
ecrit au moyen d'un QDataStream ou d'un QTextStream. Une difference notable entre la 
lecture de donnees a partir d'un reseau et celle effectuee depuis un fichier est que nous devons 
veiller a avoir recu suffisamment de donnees avant d'utiliser l'operateur ». Dans le cas 
contraire, nous obtenons un comportement aleatoire. 



Chapitre 14 



Gestion de reseau 343 



Dans cette section, nous allons examiner le code d'un client et d'un serveur qui utilisent un 
protocole personnalise oriente bloc. Le client se nomme Trip Planner et permet aux utilisateurs 
de planifier leur prochain voyage ferroviaire. Le serveur se nomme Trip Server et fournit les 
informations concernant le voyage au client. Nous allons commencer par ecrire le client Trip 
Planner. 

Trip Planner fournit les champs From, To, Date et Approximate Time ainsi que deux boutons 
d'option indiquant si l'heure approximative est celle de depart ou d'arrivee. Lorsque l'utilisa- 
teur clique sur Search, l'application expedie une requete au serveur, qui renvoie une liste des 
trajets correspondant aux criteres de l'utilisateur. La liste est presentee sous la forme d'un 
QTableWidget dans la fenetre Trip Planner. Le bas de la fenetre est occupe par un QProgres- 
sBar ainsi que par un QLabel qui affiche le statut de la derniere operation. (Voir Figure 14.1) 
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L interface utilisateur de Trip Planner a ete creee au moyen de Qt Designer dans un fichier 
nomme tripplanner . ui. Ici, nous allons nous concentrer sur le code source de la sous- 
classe QDialog qui implemente la fonctionnalite de l'application : 

#include "ui_tripplanner.h" 

class TripPlanner : public QDialog, public Ui: :TripPlanner 
{ 

Q_0BJECT 
public: 

TripPlanner (QWidget *parent = 0); 

private slots: 

void connectToServer() ; 

void sendRequest() ; 

void updateTableWidget() ; 

void stopSearchf) ; 

void connectionClosedByServer() ; 

void errorf ) ; 
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private: 

void closeConnection() ; 

QTcpSocket tcpSocket; 
quint16 nextBlockSize; 

}; 

La classe TripPlanner herite de Ui : : TripPlanner (qui est genere par le uic de tripplan- 
ner.ui) en plus de QDialog. La variable membre tcpSocket encapsule la connexion TCP. 
La variable nextBlockSize est utilisee lors de 1' analyse des blocs recus du serveur. 

TripPlanner: :TripPlanner(QWidget *parent) 
: QDialog(parent) 

{ 

setupUi(this) ; 

QDateTime dateTime = QDateTime: :currentDateTime( ) ; 
dateEdit->setDate(dateTime.date( ) ) ; 
timeEdit->setTime (QTime (dateTime. time ( ) . hour( ) , 0) ) ; 

progressBar->hide( ) ; 

progressBar->setSizePolicy (QSizePolicy :: Preferred , 

QSizePolicy : : Ignored) ; 

tableWidget->verticalHeader( )->hide( ) ; 

tableWidget->setEditTriggers(QAbstractItemView: :NoEditTriggers) ; 

connectfsearchButton, SIGNAL(clicked( ) ) , 
this, SLOT(connectToServer( ) ) ) ; 
connect(stopButton, SIGNAL(clicked( ) ) , this, SLOT(stopSearch())) ; 

connect (&tcpSocket, SIGNAL(connected( ) ) , this, SLOT(sendRequest( ) ) ) ; 
connect (&tcpSocket, SIGNAL(disconnected( ) ) > 

this, SLOT(connectionClosedByServer( ) ) ) ; 
connect (&tcpSocket, SIGNAL (readyRead() ) , 

this, SLOT(updateTableWidget ( ) ) ) ; 
connect (&tcpSocket, SIGNAL(error(QAbstractSocket: :SocketError) ) , 

this, SLOT(error() ) ) ; 

} 

Dans le constructeur, nous initialisons les editeurs de date et d'heure en fonction de la date et 
de l'heure courantes. Nous masquons egalement la barre de progression, car nous souhaitons 
ne rafficher que lorsqu'une connexion est active. Dans Qt Designer, les proprietes minimum et 
maximum de la barre de progression sont toutes deux derinies en 0, ce qui indique au QPro- 
gressBar de se comporter comme un indicateur d'activite au lieu d'une barre de progression 
standard basee sur les pourcentages. 

En outre , dans le constructeur, nous connectons les signaux connected(), disconnected(), 
readyRead() et error (QAbstractSocket : : SocketError) de QTcpSocket a des slots 
prives. 
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void TripPlanner: :connectToServer( ) 
{ 

tcpSocket.connectToHost("tripserver.zugbahn.de" , 6178) ; 

tableWidget->setRowCount(0) ; 
searchButton->set Enabled (false) ; 
stopButton->setEnabled(true) ; 

statusLabel->setText(tr( "Connecting to server...")); 
progressBar->show( ) ; 

nextBlockSize = 0; 

} 

Le slot connectToServer ( ) est execute lorsque l'utilisateur clique sur Search pour lancer 
une recherche. Nous appelons connectToHost ( ) sur l'objet QTcpSocket pour etablir une 
connexion avec le serveur, que nous supposons etre accessible par le biais du port 6178 sur 
l'hote fictif tripserver.zugbahn.de. (Si vous souhaitez tester l'exemple sur votre propre 
machine, remplacez le nom de l'hote par QHostAddress : : LocalHost.) L'appel de connect- 
ToHost ( ) est asynchrone. II rend toujours le controle immediatement. La connexion est gene- 
ralement etablie ulterieurement. L'objet QTcpSocket emet le signal connected ( ) lorsque la 
connexion fonctionne ou error (QAbstractSocket : :SocketError) en cas d'echec. 

Nous mettons ensuite a jour 1' interface utilisateur, en particulier en affichant la barre de 
progression. 

Nous definissons enfin la variable nextBlockSize en 0. Cette variable stocke la longueur du 
prochain bloc en provenance du serveur. Nous avons choisi d'utiliser la valeur 0 pour indiquer 
que nous ne connaissons pas encore la taille du bloc a venir. 

void TripPlanner: :sendRequest() 
{ 

QByteArray block; 

QDataStream out(&block, QIC-Device: :WriteOnly) ; 
out.setVersion(QDataStream: :Qt_4_1 ) ; 

out « quint16(0) « quint8('S') « fromComboBox->currentText() 
« toComboBox->currentText() « dateEdit->date( ) 
« timeEdit->time( ) ; 

if (departureRadioButton->isChecked( ) ) { 

out « quint8( ' D ' ); 
} else { 

out « quint8( 'A' ) ; 

} 

out.device()->seek(0) ; 

out « quint16(block.size( ) - sizeof (quint16) ) ; 
tcpSocket.write(block) ; 

statusLabel->setText(tr( "Sending request ...")); 

} 
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Le slot sendRequest ( ) est execute lorsque l'objet QTcpSocket emet le signal connected ( ), 
indiquant qu'une connexion a ete etablie. La tache du slot consiste a generer une requete a 
destination du serveur, avec toutes les informations entrees par l'utilisateur. 

La requete est un bloc binaire au format suivant : 



quint16 


Taille du bloc en octets (excluant ce champ) 


quint8 


Type de requete (toujours 'S') 


QString 


Ville de depart 


QString 


Ville d'arrivee 


QDate 


Date du voyage 


QTime 


Horaire approximatif du voyage 


quint8 


Heure de depart ('D') ou d'arrivee ('A') 



Dans un premier temps, nous ecrivons les donnees dans un QByteArray nomme block. Nous 
ne pouvons pas ecrire les donnees directement dans le QTcpSocket car nous ne connaissons 
pas la taille du bloc avant d'y avoir place toutes les donnees. 

Nous avons initialement indique 0 pour la taille du bloc, suivi du reste des donnees. Nous 
appelons ensuite seek(0) sur le peripherique d'E/S (un QBuffer cree par QDataStream a 
l'arriere-plan) pour revenir au debut du tableau d'octets, et nous remplacons le 0 initial par la 
taille des donnees du bloc. Elle est calculee en prenant la taille du bloc et en soustrayant 
sizeof (quintl 6) (c'est-a-dire 2) pour exclure le champ de taille du compte d'octets. Nous 
appelons alors write ( ) sur le QTcpSocket pour envoyer le bloc au serveur. 

void TripPlanner: :updateTableWidget() 
{ 

QDataStream in(&tcpSocket) ; 

in. setVersion (QDataStream: :Qt_4_1 ) ; 

forever { 

int row = tableWidget->rowCount() ; 

if (nextBlockSize == 0) { 

if (tcpSocket.bytesAvailable() < sizeof (quint16) ) 

break; 
in » nextBlockSize; 

} 

if (nextBlockSize == OxFFFF) { 
closeConnection() ; 

statusLabel->setText(tr( "Found %1 trip(s) ") .arg(row) ) ; 
break; 

} 
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if (tcpSocket.bytesAvailable( ) < nextBlockSize) 
break; 

QDate date; 
QTime departureTime; 
QTime arrivalTime; 
quint16 duration; 
quint8 changes; 
QString trainType; 

in » date » departureTime » duration » changes » trainType; 
arrivalTime = departureTime. addSecs (duration * 60); 

tableWidget->setRowCount(row +1); 

QStringList fields; 

fields « date.toString(Qt: :LocalDate) 

« depart ureTime.toString(tr("hh: mm" ) ) 
« arrivalTime. toString(tr( "hh:mm" ) ) 
« tr("%1 hr %2 min" ) .arg(duration / 60) 

.arg(duration % 60) 
« QString: :number(changes) 
« trainType; 
for (int i = 0; i < fields. count() ; ++i) 
tableWidget->setItem(row, i, 

new QTableWidgetItem(fields[i] ) ) ; 

nextBlockSize = 0; 

} 

} 

Le slot updateTableWidget ( ) est connecte au signal readyRead ( ) de QTcpSocket, qui est 
emis des que le QTcpSocket recoit de nouvelles donnees en provenance du serveur. Le serveur 
nous envoie une liste des trajets possibles correspondant aux criteres de l'utilisateur. Chaque 
trajet est expedie sous la forme d'un bloc unique. La boucle forever est necessaire dans la 
mesure ou nous ne recevons pas obligatoirement un seul bloc de donnees a la fois de la part du 
serveur. Nous pouvons recevoir un bloc entier, une partie de celui-ci, un bloc et demi ou encore 
tous les blocs a la fois. (Voir Figure 14.2) 

Figure 14.2 51 octets 48 octets 53 octets 
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OxFFFF 



Comment fonctionne la boucle forever ? Si la variable nextBlockSize a pour valeur 0, 
nous n'avons pas lu la faille du bloc suivant. Nous essayons de la lire (en prenant en compte le 
fait que deux octets au moins sont disponibles pour la lecture). Le serveur utilise une valeur de 
faille de OxFFFF pour indiquer qu'il ne reste plus de donnees a recevoir. Ainsi, si nous lisons 
cette valeur, nous savons que nous avons atteint la fin. 
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Si la taille du bloc n'est pas de 0xFFFF, nous essayons de lire le bloc suivant. Dans un premier 
temps, nous essayons de determiner si des octets de taille de bloc sont disponibles a la lecture. 
Si tel n'est pas le cas, nous interrompons cette action un instant. Le signal readyRead ( ) sera 
de nouveau emis lorsque des donnees supplementaires seront disponibles. Nous procederons 
alors a de nouvelles tentatives. 

Lorsque nous sommes certains que le bloc entier est arrive, nous pouvons utiliser l'operateur 
» en toute securite sur le QDataStream pour extraire les informations relatives au voyage, et 
nous creons un QTableWidget Items avec ces informations. Le format d'un bloc recu du 
serveur est le suivant : 



quint16 


Taille du bloc en octets (en excluant son champ) 


QDate 


Date de depart 


QTime 


Heure de depart 


quint16 


Duree (en minutes) 


quint8 


Nombre de changements 


QString 


Type de train 



A la fin, nous reinitialisons la variable nextBlockSize en 0 pour indiquer que la taille du bloc 
suivant est inconnue et doit etre lue. 

void TripPlanner: :closeConnection( ) 
{ 

tcpSocket. close)) ; 
searchButton->setEnabled(true) ; 
stopButton->setEnabled(false) ; 
progressBar->hide( ) ; 

} 

La fonction privee closeConnection ( ) ferme la connexion avec le serveur TCP et met a jour 
l'interface utilisateur. Elle est appelee depuis updateTableWidget ( ) lorsque 0XFFFF est lu 
ainsi que depuis plusieurs autres slots sur lesquels nous reviendrons dans un instant. 

void TripPlanner: :stopSearch() 
{ 

statusLabel->setText(tr( "Search stopped" ) ) ; 
closeConnectionf) ; 

} 

Le slot stopSearch ( ) est connecte au signal clicked ( ) du bouton Stop. II appelle simplement 
closeConnection ( ). 

void TripPlanner: :connectionClosedByServer( ) 
{ 
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if (nextBlockSize != OxFFFF) 

statusLabel->setText(tr( "Error: Connection closed by server")); 
closeConnectionf) ; 

} 

Le slot connectionClosedByServer ( ) est connecte au signal disconnected ( ) du QTcp- 
Socket. Si le serveur ferme la connexion sans que nous ayons encore recu le marqueur 
OxFFFF de fin de donnees, nous indiquons a l'utilisateur qu'une erreur s'est produite. Nous 
appelons normalement closeConnection ( ) pour mettre a jour l'interface utilisateur. 

void TripPlanner: :error( ) 
{ 

statusLabel->setText(tcpSocket.errorString() ) ; 
closeConnectionf) ; 

} 

Le slot error() est connecte au signal error (QAbstractSocket : :SocketError) du 
QTcpSocket. Nous ignorons le code d'erreur et nous utilisons QTcpSocket :: error- 
String () , qui retourne un message en texte clair concernant la derniere erreur detectee. 

Tout ceci concerne la classe TripPlanner. Comme nous pouvons nous y attendre, la fonction 
main ( ) de 1' application TripPlanner est la suivante : 

int mainfint argc, char *argv[]) 
{ 

QApplication appfargc, argv); 
TripPlanner tripPlanner; 
tripPlanner. showf) ; 
return app.execf) ; 

} 

Implementons maintenant le serveur. Ce dernier est compose de deux classes : TripServer et 
ClientSocket. La classe TripServer herite de QTcpServer, une classe qui nous permet 
d'accepter des connexions TCP entrantes. ClientSocket reimplemente QTcpSocket et gere 
une connexion unique. II existe a chaque instant autant d'objets ClientSocket en memoire 
que de clients servis. 

class TripServer : public QTcpServer 
{ 

Q_0BJECT 
public: 

TripServerfQObject *parent = 0); 
private: 

void incomingConnectionfint socketld); 

}; 

La classe TripServer reimplemente la fonction incomingConnection ( ) depuis QTcpServer. 
Cette fonction est appelee des qu'un client tente d'etablir une connexion au port ecoute par le 
serveur. 



350 Qt4 et C++ : Programmation d'interfaces GUI 



TripServer: :TripServer(QObject *parent) 
: QTcpServer(parent) 

{ 
} 

Le constructeur TripServer est simple. 

void TripServer: :incomingConnection(int socketld) 
{ 

ClientSocket *socket = new ClientSocket(this) ; 
socket->setSocketDescriptor( socket Id) ; 

} 

Dans incomingConnection ( ), nous creons un objet ClientSocket qui est un enfant de 
l'objet TripServer, et nous attribuons a son descripteur de socket le nombre qui nous a ete 
fourni. L'objet ClientSocket se supprimera automatiquement de lui-meme une fois la 
connexion terminee. 

class ClientSocket : public QTcpSocket 
{ 

Q_0BJECT 
public: 

ClientSocket (QObject *parent = 0); 

private slots: 

void readClient() ; 

private: 

void generateRandomTrip(const QString &from, const QString &to, 

const QDate &date, const QTime &time); 

quint16 nextBlockSize; 

}; 

La classe ClientSocket herite de QTcpSocket et encapsule l'etat d'un client unique. 

ClientSocket: :ClientSocket(QObject *parent) 
: QTcpSocket (parent) 

{ 

connect(this, SIGNAL ( readyRead ( ) ) , this, SLOT(readClient ( ) ) ) ; 
connect(this, SIGNAL(disconnected( ) ) , this, SLOT(deleteLater( ) ) ) ; 
nextBlockSize = 0; 

} 

Dans le constructeur, nous etablissons les connexions signal/slot necessaires, et nous definis- 
sons la variable nextBlockSize en 0, indiquant ainsi que nous ne connaissons pas encore la 
taille du bloc envoye par le client. 

Le signal disconnected ( ) est connecte a deleteLater ( ), une fonction heritee de QObj ect 
qui supprime l'objet lorsque le controle retourne a la boucle d'evenement de Qt. De cette 
facon, l'objet ClientSocket est supprime lorsque la connexion du socket est fermee. 
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void ClientSocket: :readClient() 
{ 

QDataStream in(this) ; 
in.setVersion(QDataStream: :Qt_4_1 ) ; 

if (nextBlockSize == 0) { 

if (bytesAvailable() < sizeof (quint16) ) 

return; 
in » nextBlockSize; 

} 

if (bytesAvailable( ) < nextBlockSize) 
return; 

quint8 requestType; 
QString from; 
QString to; 
QDate date; 
QTime time; 
quint8 flag; 

in » requestType; 

if (requestType == 'S' ) { 

in » from » to » date » time » flag; 

srand(from.length() * 3600 + to. length () * 60 + time.hour( ) ) ; 

int numTrips = rand() % 8; 

for (int i = 0; i < numTrips; ++i) 

generateRandomTrip(f rom, to, date, time); 

QDataStream out(this); 
out « quint16(0xFFFF) ; 

} 

close( ) ; 

} 

Le slot readClient ( ) est connecte au signal readyRead ( ) du QTcpSocket. Si nextBlock- 
Size est defini en 0, nous commencons par lire la taille du bloc. Dans le cas contraire, nous 
l'avons deja lue. Nous poursuivons done en verifiant si un bloc entier est arrive, et nous le 
lisons d'une seule traite. Nous utilisons QDataStream directement sur le QTcpSocket (l'objet 
this) et lisons les champs au moyen de 1' operate ur ». 

Une fois la requete du client lue, nous sommes prets a generer une reponse. Dans le cas d'une 
application reelle, nous rechercherions les informations dans une base de donnees d'horaires et 
tenterions de trouver les trajets correspondants. Ici, nous nous contenterons d'une fonction 
nommee generateRandomTrip( ) qui generera un trajet aleatoire. Nous appelons la fonction 
un nombre quelconque de fois, puis nous envoyons 0xFFFF pour signaler la fin des donnees. 
Enfin, nous fermons la connexion. 

void ClientSocket: :generateRandomTrip(const QString & /* from */, 

const QString & /* to */, const QDate &date, const QTime &time) 
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{ 

QByteArray block; 

QDataStream out(&block, QIODevice: :WriteOnly) ; 
out. setversion (QDataStream: :Qt_4_1 ) ; 
quint16 duration = rand() % 200; 

out « quint16(0) « date « time « duration « quint8(1) 

« QString( "Intercity" ) ; 
out.device()->seek(0) ; 

out « quint16(block.size( ) - sizeof (quint16) ) ; 
write(block) ; 

} 

La fonction generateRandomTrip( ) illustre comment envoyer un bloc de donnees par le 
biais d'une connexion TCP. Ce processus est tres similaire a celui suivi sur le client, dans la 
fonction sendRequest ( ). Une fois encore, nous ecrivons le bloc dans un QByteArray en 
executant write ( ) , de facon a pouvoir determiner sa taille avant de l'envoyer. 

int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
TripServer server; 

if ( !server.listen(QHostAddress: :Any, 6178)) { 
cerr « "Failed to bind to port" « endl; 
return 1 ; 

} 

QPushButton quitButton(QObject: :tr( "&Quit" ) ) ; 
quitButton.setWindowTitle(QObject: :tr("Trip Server")) ; 
QObject: :connect(&quitButton, SIGNAL(clicked( ) ) , 

&app, SL0T(quit())); 
quitButton.show() ; 
return app.exec() ; 

} 

Dans main ( ) , nous creons un objet TripServer et un QPushButton qui permet a l'utilisateur 
d'arreter le serveur. Nous lancons le serveur en appelant QTcpSocket : : listen ( ), qui recoit 
l'adresse IP et le numero de port sur lequel nous souhaitons accepter les connexions. L'adresse 
speciale 0.0.0.0 (QHostAddress : : Any) signifie toute interface IP presente sur l'hote local. 

Ceci termine notre exemple client/serveur. Ici, nous avons utilise un protocole oriente bloc qui 
nous permet de faire appel a QDataStream pour la lecture et l'ecriture. Si nous souhaitions 
utiliser un protocole oriente ligne, l'approche la plus simple serait de recourir aux fonctions 
canReadLine ( ) et readl_ine() de QTcpSocket dans un slot connecte au signal ready- 
Read () : 

QStringList lines; 

while (tcpSocket.canReadLine() ) 

lines. append (tcpSocket . readLine( ) ) ; 
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Nous traiterions alors chaque ligne lue. Comme pour 1' envoi des donnees, ceci pourrait etre 
effectue en utilisant un QTextStream sur le QTcpSocket. 

L' implementation serveur que nous avons utilisee n'est pas adaptee a une situation ou les 
connexions sont nombreuses. En effet, lorsque nous traitons une requete, nous ne gerons pas 
les autres connexions. Une approche plus souple consisterait a demarrer un nouveau thread pour 
chaque connexion. L'exemple Threaded Fortune Server situe dans le repertoire examples/ 
network/threadedf ortuneserver illustre ce precede. 



Envoi et reception de datagrammes UDP 

La classe QUdpSocket peut etre utilisee pour envoyer et recevoir des datagrammes UDP. UDP 
est un protocole oriente datagramme non fiable. Certains protocoles de niveau application utili- 
sent UDP car il est plus leger que TCP. Avec UDP, les donnees sont envoyees sous forme de 
paquets (datagrammes) d'un hote a un autre. II n'existe pas de concept de connexion, et si un 
paquet UDP n'est pas remis avec succes, aucune erreur n'est signalee a l'expediteur. (Voir 
Figure 14.3) 



Figure 14.3 

L' application 
Weather Station 



Weather Station 



0® 



Date: 

Time: 1 10:11:51 



'.Ved Feb M 2ZZZ 



Temperature: -19.2711 ; C 
Humidity: 1 20. 1828% 
Attitude: 1 7001 .5 m 



Les exemples Weather Balloon et Weather Station vous montreront comment utiliser UDP a 
partir d'une application Qt. L application Weather Balloon reproduit un ballon meteo qui 
envoie un datagramme UDP (au moyen d'une connexion sans fil) contenant les conditions 
atmospheriques courantes toutes les deux secondes. L application Weather Station recoit 
ces datagrammes et les affiche a l'ecran. Nous allons commencer par le code du Weather 
Ballon. 

class WeatherBalloon : public QPushButton 
{ 

Q_0BJECT 
public: 

WeatherBalloon (QWidget *parent = 0); 



double temperature( ) const; 
double humidity () const; 



354 Qt4 et C++ : Programmation d'interfaces GUI 



double altitude)) const; 

private slots: 

void sendDatagram) ) ; 

private: 

QUdpSocket udpSocket; 
QTimer timer; 

}; 

La classe WeatherBalloon herite de QPushButton. Elle utilise sa variable privee QUdpSocket 
pour communiquer avec la station meteo (Weather Station). 

WeatherBalloon: :WeatherBalloon(QWidget *parent) 
: QPushButton(tr("Quit"), parent) 

{ 

connect(this, SIGNAL(clicked( ) ) , this, SLOT(close( ) ) ) ; 

connect (&timer, SIGNAL (timeout ()) , this, SLOT(sendDatagram) ) ) ) ; 

timer. start(2 * 1000) ; 

setWindowTitle(tr( "Weather Balloon" ) ) ; 

} 

Dans le constructeur, nous lancons un QTimer pour invoquer sendDatagram ( ) toutes les 
deux secondes. 

void WeatherBalloon: :sendDatagram() 
{ 

QByteArray datagram; 

QDataStream out(&datagram, QIODevice: :WriteOnly) ; 
out.setVersion(QDataStream: :Qt_4_1 ) ; 

out « QDateTime: :currentDateTime() « temperature( ) « humidityf) 
« altitude)) ; 

udpSocket. writeDatagram(datagram, QHostAddress: :LocalHost, 5824) ; 

} 

Dans sendDatagram) ), nous generons et envoyons un datagramme contenant la date, l'heure, 
la temperature, l'humidite et 1' altitude : 



QDateTime 


Date et heure de mesure 


double 


Temperature (en °C) 


double 


Humidite (en %) 


double 


Altitude (in metres) 
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Le datagramme est expedie au moyen de QUdpSocket : : writeDatagram ( ). Les deuxieme 
et troisieme arguments de writeDatagram ( ) sont l'adresse IP et le numero de port de 
l'homologue (la Weather Station). Nous supposons ici que la Weather Station s'execute sur 
la meme machine que le Weather Balloon. Nous utilisons done l'adresse IP 127.0.0.1 (QHost- 
Address : : LocalHost), une adresse speciale qui designe l'hote local. 

Contrairement aux sous-classes de QAbstractSocket, QUdpSocket accepte uniquement les 
adresses d'hote, mais pas les noms. Si nous devions convertir un nom d'hote en son adresse IP, 
deux solutions s'offriraient a nous : si nous nous sommes prepares a un blocage pendant la 
recherche, nous pouvons faire appel a la fonction statique QHostlnf o : : f romName ( ). Dans le cas 
contraire, nous employons la fonction statique QHostlnf o :: lookupHost ( ), qui rend le 
controle immediatement et, une fois la recherche terminee, appelle le slot qui lui est transmis 
avec un objet QHostlnf o contenant les adresses correspondantes. 

int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
WeatherBalloon balloon; 
balloon. show() ; 
return app.execf) ; 

} 

La fonction main ( ) cree simplement un objet WeatherBalloon, qui sert a la fois d'homo- 
logue UDP et de QPushButton a l'ecran. En cliquant sur le QPushButton, l'utilisateur quitte 
P application. 

Revenons maintenant au code source du client Weather Station. 

class Weatherstation : public QDialog 
{ 

Q_0BJECT 
public: 

Weatherstation (QWidget *parent = 0); 

private slots: 

void processPendingDatagrams( ) ; 

private: 

QUdpSocket udpSocket; 

QLabel *dateLabel; 
QLabel *timeLabel; 

QLineEdit *altitudeLineEdit; 

}; 

La classe Weatherstation herite de QDialog. Elle ecoute un port UDP particulier, analyse 
tous les datagrammes entrants (en provenance du Weather Balloon) et affiche leur contenu 
dans cinq QLineEdits en lecture seulement. La seule variable privee presentant un interet ici 
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est la variable udpSocket du type QUdpSocket, a laquelle nous allons faire appel pour recevoir les 
datagrammes. 

Weatherstation: :WeatherStation(QWidget *parent) 
: QDialog(parent) 

{ 

udpSocket. bind (5824) ; 

connect (&udpSocket, SIGNAL(readyRead()) , 
this, SLOT(processPendingDatagrams( ) ) ) ; 

} 

Dans le constructeur, nous commencons par etablir une liaison entre le QUdpSocket et le port 
auquel le Weather Balloon transmet ses donnees. Comme nous n'avons pas specifie d'adresse 
note, le socket accepte les datagrammes envoyes a n'importe quelle adresse IP appartenant a la 
machine sur laquelle s'execute la Weather Station. Puis nous connectons le signal ready- 
Read ( ) du socket au processPendingDatagrams ( ) prive qui extrait les donnees et les affiche. 

void Weatherstation : : processPendingDatagrams ( ) 
{ 

QByteArray datagram; 
do { 

datagram. resize (udpSocket .pendingDatagramSize( ) ) ; 
udpSocket . readDatagram(datagram.data( ) , datagram. size( ) ) ; 
} while (udpSocket . hasPendingDatagrams( )) ; 

QDateTime dateTime; 
double temperature; 
double humidity; 
double altitude; 

QDataStream in(&datagram, QIODevice: :ReadOnly) ; 

in.setVersion(QDataStream: :Qt_4_1 ) ; 

in » dateTime » temperature » humidity » altitude; 

dateLineEdit->setText(dateTime.date() .toString() ) ; 
timeLineEdit->setText(dateTime.time() .toStringj) ) ; 
temperatureLineEdit->setText(tr( "%1 °C" ) .arg(temperature) ) ; 
humidityLineEdit->setText(tr( ) .arg(humidity) ) ; 
altitudeLineEdit->setText(tr( "%1 m" ) .arg(altitude) ) ; 

} 

Le slot processPendingDatagrams ( ) est appele quand un datagramme est arrive. QUdpSocket 
place les datagrammes entrants en file d'attente et nous permet d'y acceder un par un. Norma- 
lement, il ne devrait y avoir qu'un seul datagramme, mais nous ne pouvons pas exclure la 
possibility que l'expediteur en envoie plusieurs a la fois avant que le signal readyP>ead( ) ne 
soit emis. Dans ce cas, nous les ignorons tous, a l'exception du dernier. Les precedents vehiculent 
en effet des informations obsoletes. 
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La fonction pendingDatagramSize ( ) retourne la taille du premier datagramme en attente. 
Du point de vue de 1' application, les datagrammes sont toujours envoyes et recus sous la forme 
d'une unite de donnees unique. Ainsi, si des octets quelconques sont disponibles, le data- 
gramme entier peut etre lu. L'appel dereadDatagram() copie le contenu du premier datagramme 
en attente dans la memoire tampon char* specifiee (en troquant les donnees si la capacite de 
cette memoire n'est pas suffisante) et passe au datagramme suivant en attente. Une fois tous les 
datagrammes lus, nous decomposons le dernier (celui avec les mesures atmospheriques les plus 
recentes) et alimentons le QLineEdits avec les nouvelles donnees. 

int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
Weatherstation station; 
station. show() ; 
return app.execf) ; 

} 

Enfin, nous creons et affichons la Weatherstation dans main ( ). 

Nous en avons maintenant termine avec notre emetteur et destinataire UDP. Les applications 
sont aussi simples que possible, puisque le Weather Balloon envoie des datagrammes a la 
Weather Station qui les recoit. Dans la plupart des cas du monde reel, les deux applications 
auraient besoin d'effectuer des operations de lecture et d'ecriture sur leur socket. 

Un numero de port et une adresse hote peuvent etre transmis aux fonctions QUdpSocket : : write- 
Datagram( ), de sorte que le QUdpSocket puisse realiser une lecture depuis l'hote et le port 
auquel il est lie avec bind ( ) , et effectuer une operation de lecture vers un autre hote ou port. 
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Au sommaire de ce chapitre 

✓ Lire du code XML avec SAX 

✓ Lire du code XML avec DOM 
Ecrire du code XML 



XML (Extensible Markup Language) est un format de fichier texte polyvalent, popu- 
late pour l'echange et le stockage des donnees. Qt fournit deux API distinctes faisant 
partie du module QtXml pour la lecture de documents XML : 

• SAX (Simple API for XML) rapporte des "evenements d' analyse" directement a 
1' application par le biais de fonctions virtuelles. 

• DOM (Document Object Model) convertit une documentation XML en une structure 
arborescente, que 1' application peut parcourir. 

Trois facteurs principaux sont a prendre en compte lors du choix entre DOM et SAX 
pour une application particuliere. SAX est de niveau inferieur et generalement plus 
rapide, ce qui le rend particulierement approprie pour des taches simples (telles que la 
recherche de toutes les occurrences d'une balise donnee dans un document XML) ou 
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pour la lecture de fichiers de tres grande taille pour lesquels la memoire sera insuffisante. Mais 
pour de nombreuses applications, la commodite de DOM prime sur la vitesse potentielle et les 
avantages offerts par SAX concernant la memoire. 

Pour ecrire des fichiers XML, deux options sont disponibles : nous pouvons generer le code 
XML manuellement, ou representer les donnees sous la forme d'un arbre DOM en memoire et 
demander a ce dernier de s' ecrire par lui-meme dans un fichier. 

Lire du code XML avec SAX 

SAX est une API standard de domaine public destinee a la lecture de documents XML. Les 
classes SAX de Qt sont modelees sur 1' implementation SAX2 de Java, avec quelques differences 
dans 1' attribution des noms arm de s'adapter aux conventions de Qt. Pour plus d' informations 
concernant SAX, reportez-vous a l'adresse http://www.saxproject.org/. 

Qt fournit un analyseur XML base sur SAX nomme QXmlSimpleReader. Cet analyseur 
reconnait du code XML bien forme et prend en charge les espaces de noms XML. Quand il 
parcourt le document, il appelle les fonctions virtuelles des classes gestionnaires enregistrees 
pour signaler des evenements d'analyse. (Ces "evenements d'analyse" n'ont aucun rapport 
avec les evenements Qt, tels que les evenements touche et souris.) Supposons, par exemple que 
1' analyseur examine le document XML suivant : 

<doc> 

<quote>Ars longa vita brevis</quote> 
</doc> 

II appelle les gestionnaires d'evenements d'analyse ci-apres : 

startDocumentQ 

startElement( "doc" ) 

startElement( "quote" ) 

characters( "Ars longa vita brevis") 

endElement( "quote") 

endElement( "doc" ) 

endDocument() 

Ces fonctions sont toutes declarees dans QXmlContentHandler. Pour des questions de simpli- 
city, nous avons omis certains arguments de startElement ( ) et endElement ( ). 

QXmlContentHandler est juste l'une des nombreuses classes gestionnaires susceptible d'etre 
utilisee avec QXmlSimpleReader. Les autres sont QXmlEntityResolver, QXmlDTDHandler, 
QXmlErrorHandler, QXmlDeclHandler et QXmlLexicalHandler. Ces classes ne declarent 
que des fonctions purement virtuelles et fournissent des informations concernant les differents 
types d'evenements d'analyse. Pour la plupart des applications, QXmlContentHandler et 
QXmlErrorHandler sont les deux seules necessaires. 



Chapitre 15 



XML 361 



Pour des raisons de commodite, Qt fournit aussi QXmlDef aultHandler, une classe qui herite 
de toutes les classes gestionnaires et qui fournit des implementations simples de toutes les 
fonctions. Une telle conception, avec de nombreuses classes gestionnaires abstraites et une 
sous-classe simple, est inhabituelle pour Qt. Elle a ete adoptee pour se conformer a 1' imple- 
mentation de modele Java. 

Nous allons etudier un exemple qui illustre comment utiliser QXmlSimpleReader et QXml- 
Def aultHandler pour analyser un fichier XML ad hoc et afficher son contenu dans un 
QTreeWidget. La sous-classe QXmlDef aultHandler se nomme SaxHandler, et le format 
gere par celle-ci est celui d'un index de livre, avec les entrees et les sous-entrees. 



Figure 15.1 

Arbre d' heritage 
pour SaxHandler 



QXmlContentHandler QXmlDTDHandler QXmlLexicalHandler 



QXmlErrorHandler 



QXmlEntityResolver 



QXmlDeclHandler 



QXmlDefaultHandler 
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SaxHandler 



Voici le fichier d'index qui est affiche dans le QTreeWidget en Figure 15.2 : 

<?xml version="1 .0"?> 
<bookindex> 

<entry term="sidebearings"> 
<page>10</page> 
<page>34-35</page> 
<page>307-308</page> 
</entry> 

<entry term="subtraction"> 
<entry term="of pictures'^ 

<page>115</page> 

<page>244</page> 
</entry> 

<entry term="of vectors"> 

<page>9</page> 
</entry> 
</entry> 
</bookindex> 



Figure 15.2 

Un fichier d'index affiche 
dans un QTreeWidget 
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La premiere etape dans 1' implementation de l'analyseur consiste a definir la sous-classe QXml- 
Def aultHandler : 

class SaxHandler : public QXmlDefaultHandler 
{ 

public: 

SaxHandler (QTreeWidget *tree); 

bool startElement (const QString &namespaceURI , 
const QString &localName, 
const QString &qName, 
const QXmlAttributes &attributes) ; 
bool endElement (const QString &namespacellRI , 
const QString &localName, 
const QString &qName); 
bool charactersfconst QString &str); 
bool f atalError(const QXmlParseException &exception); 

private: 

QTreeWidget *treeWidget; 
QTreeWidgetltem "currentltem; 
QString currentText; 

}; 

La classe SaxHandler herite de QXmlDefaultHandler et reimplemente quatre fonc- 
tions : startElement ( ), endElement () , characters ( ) et f atalError ( ) . Les trois 
premieres sont declarees dans QXmlContentHandler. La derniere est declaree dans QXml- 
ErrorHandler. 

SaxHandler: :SaxHandler(QTreeWidget *tree) 
{ 

treeWidget = tree; 
currentltem = 0; 

} 

Le constructeur SaxHandler accepte le QTreeWidget que nous souhaitons remplir avec les 
informations stockees dans le fichier XML. 

bool SaxHandler: : startElement (const QString & /* namespaceURI */, 

const QString & /* localName */, 
const QString &qName, 
const QXmlAttributes &attributes) 

{ 

if (qName == "entry") { 
if (currentltem) { 

currentltem = new QTreeWidgetltem(currentltem) ; 
} else { 

currentltem = new QTreeWidgetltem(treeWidget) ; 

} 
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current Item->setText (0, attributes. value ( "term" ) ) ; 
} else if (qName == "page") { 
currentText. clearf ) ; 

} 

return true; 

} 

La fonction startElement ( ) est appelee des que le lecteur rencontre une nouvelle balise 
d'ouverture. Le troisieme parametre est le nom de la balise (ou plus precisement, son "nom 
qualirie"). Le quatrieme parametre est la liste des attributs. Dans cet exemple, nous ignorons 
les premier et deuxieme parametres. lis sont utiles pour les fichiers XML qui utilisent le meca- 
nisme d'espace de noms de XML, un sujet qui est traite en detail dans la documentation de 
reference. 

Si la balise est <entry>, nous creons un nouvel element QTreeWidget. Si elle est imbriquee 
dans une autre balise <entry>, la nouvelle balise definit une sous-entree dans l'index, et le 
nouveau QTreeWidget Item est cree en tant qu'enfant du QTreeWidget Item qui represente 
l'entree principale. Dans le cas contraire, nous creons le QTreeWidget Item avec l'element 
treeWidget en tant que parent, en faisant de celui-ci un element de haut niveau. Nous appe- 
lons setText ( ) pour definir le texte presente en colonne 0 avec la valeur de l'attribut term de 
la balise <entry>. 

Si la balise est <page>, nous definissons le currentText en une chaine vide. Le current- 
Text sert d'accumulateur pour le texte situe entre les balises <page> et </page>. 

Nous retournons enfin true pour demander a SAX de poursuivre 1' analyse du richier. Si nous 
souhaitions signaler les balises inconnues comme des erreurs, nous retournerions false dans 
ces situations. Nous reimplementerions egalement errorString ( ) a partir de QXmlDef ault- 
Handler pour retourner un message d'erreur approprie. 

bool SaxHandler: :characters(const QString &str) 
{ 

currentText += str; 
return true; 

} 

La fonction characters () est appelee si des donnees caracteres sont rencontrees dans le 
document XML. Nous accolons simplement les caracteres a la variable currentText. 

bool SaxHandler: :endElement( const QString & /* namespaceURI */, 

const QString & /* localName */, 
const QString &qName) 

{ 

if (qName == "entry") { 

currentltem = currentltem->parent( ) ; 
} else if (qName == "page") { 

if (currentltem) { 

QString allPages = currentltem->text(1 ) ; 
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if ( ! allPages. isEmpty ( ) ) 

allPages += " , " ; 
allPages += currentText; 
currentItem->setText(1 , allPages) ; 

} 

} 

return true; 

} 

La fonction endElement ( ) est appelee quand le lecteur rencontre une balise de fermeture. 
Comme pour startElement ( ) , le troisieme parametre est le nom de la balise. 

Si la balise est </entry>, nous mettons a jour la variable privee currentltem de facon a la 
diriger vers le parent de QTreeWidgetltem en cours. De cette fagon, la variable currentltem 
reprend la valeur qui etait la sienne avant la lecture de la balise <entry> correspondante. 

Si la balise est </page>, nous ajoutons le numero de page ou la plage de pages sous la forme 
d'une liste separee par des virgules au texte de 1' element courant de la colonne 1. 

bool SaxHandler: :fatalError(const QXmlParseException Sexception) 
{ 

QMessageBox: :warning(0, QObject: :tr( "SAX Handler"), 

QObject: :tr("Parse error at line %1 , column " 

"%2:\n%3.") 
.arg(exception.lineNumber() ) 
. arg( exception. columnNumber ( ) ) 
. arg( exception. message ( ) ) ) ; 

return false; 

} 

La fonction f atalError ( ) est appelee lorsque le lecteur ne parvient pas a analyser le fichier 
XML. Dans cette situation, nous affichons simplement une boite de message, en donnant le 
numero de ligne, le numero de colonne et le texte d'erreur de l'analyseur. 

Ceci termine 1' implementation de la classe SaxHandler. Voyons maintenant comment 
l'utiliser : 

bool parseFile(const QString &fileName) 
{ 

QStringList labels; 

labels « QObject: :tr("Terms") « QObject: :tr( "Pages" ) ; 

QTreeWidget *treeWidget = new QTreeWidget; 
treeWidget->setHeaderLabels (labels) ; 
treeWidget->setWindowTitle (QObject: :tr("SAX Handler" ) ) ; 
treeWidget->show( ) ; 
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QFile file(fileName) ; 
QXmllnputSource inputSource(&f ile) ; 
QXmlSimpleReader reader; 
SaxHandler handler(treeWidget) ; 
reader .setContentHandler(&handler) ; 
reader .set ErrorHandler(&handler) ; 
return reader. parse(inputSource) ; 

} 

Nous definissons un QTreeWidget avec deux colonnes. Puis nous creons un objet QFile pour 
le fichier devant etre lu et un QXmlSimpleReader pour analyser le fichier. II n'est pas neces- 
saire d'ouvrir le QFile par nous-memes. QXmllnputSource s'en charge automatiquement. 

Nous creons enrin un objet SaxHandler, nous l'installons sur le lecteur a la fois en tant que 
gestionnaire de contenu et en tant que gestionnaire d'erreur, et nous appelons parse ( ) sur le 
lecteur pour effectuer 1' analyse. 

Au lieu de transmettre un simple objet de fichier a la fonction parse () , nous transmettons un 
QXmllnputSource. Cette classe ouvre le fichier qui lui est fourni, le lit (en prenant en consi- 
deration tout codage de caracteres specifie dans la declaration <?xml?>), et fournit une inter- 
face par le biais de laquelle l'analyseur lit le fichier. 

Dans SaxHandler, nous reimplementons uniquement les fonctions des classes QXmlContent- 
Handler et QXmlErrorHandler. Si nous avions implements des fonctions d'autres classes 
gestionnaires, nous aurions egalement du appeler leurs fonctions de reglage (set) sur le lecteur. 

Pour lier 1' application a la bibliotheque QtXml, nous devons ajouter cette ligne dans le fichier 
.pro : 

QT += xml 



Lire du code XML avec DOM 

DOM est une API standard pour 1' analyse de code XML developpee par le W3C {World Wide 
Web Consortium). Qt fournit une implementation DOM Niveau 2 destinee a la lecture, a la 
manipulation et a l'ecriture de documents XML. 

DOM presente un fichier XML sous la forme d'un arbre en memoire. Nous pouvons parcourir 
l'arbre DOM autant que necessaire. II nous est egalement possible de le modifier et de le reen- 
registrer sur le disque en tant que fichier XML. 

Considerons le document XML suivant : 
<doc> 

<quote>Ars longa vita brevis</quote> 
<translation>Art is long, life is short</translation> 
</doc> 
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II correspond a l'arbre DOM ci-apres : 



Document 

I — Element (doc) 

-Element (quote) 

I — Text ("Ars longa vita brevis") 
-Element (translation) 

I — Text ("Art is long, life is short" 



L'arbre DOM contient des noeuds de types differents. Par exemple, un noeud Element corres- 
pond a une balise d'ouverture et a sa balise de fermeture. Le material! situe entre les balises 
apparait sous la forme de noeuds enfants de Element. 

Dans Qt, les types de nceud (comme toutes les autres classes en liaison avec DOM) possedent 
un prefixe QDom. Ainsi, QDomElement represente un noeud Element, et QDomText represente 
un noeud Text. 

Chaque noeud peut posseder differents types de noeuds enfants. Par exemple, un noeud 
Element peut contenir d'autres noeuds Element, ainsi que des noeuds EntityRef erence, 
Text, CDATASection, Processinglnstruction et Comment. La Figure 15.3 presente les 
types de noeuds enfants correspondant aux noeuds parents. Ceux apparaissant en gris ne 
peuvent pas avoir de noeud enfant. 
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Relations parent/enfant entre les noeuds DOM 
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Nous allons voir comment utiliser DOM pour lire des fichiers XML en creant un analyseur 
pour le format de fichier d'index decrit dans la section precedente. 
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class DomParser 
{ 

public: 

DomParser(QIODevice *device, QTreeWidget *tree); 
private: 

void parseEntry (const QDomElement &element, 
QTreeWidgetltem *parent); 

QTreeWidget *treeWidget; 

}; 

Nous definissons une classe nommee DomParser qui analysera un index de livre se presentant 
sous la forme d'un document XML et affichera le resultat dans un QTreeWidget. Cette classe 
n'herite d'aucune autre classe. 

DomParser: : DomParser (QIODevice *device, QTreeWidget *tree) 
{ 

treeWidget = tree; 

QString errorStr; 
int errorLine; 
int errorColumn; 

QDomDocument doc; 

if ( !doc.setContent(device, true, &errorStr, &errorLine, 
&errorColumn) ) { 
QMessageBox: :warning(0, QObject: :tr("D0M Parser"), 

QObject: :tr( "Parse error at line %1 , " 

"column %2:\n%3") 
.arg(errorLine) 
.arg(errorColumn) 
.arg(errorStr) ) ; 

return; 

} 

QDomElement root = doc.documentElement() ; 
if (root.tagName() != "bookindex") 
return; 

QDomNode node = root.firstChild() ; 
while ( !node.isNull( ) ) { 

if (node.toElement() .tagName() == "entry") 
parseEntry(node.toElement() , 0); 

node = node.nextSibling() ; 

} 

} 

Dans le constructeur, nous creons un objet QDomDocument et appelons setContent() sur 
celui-ci pour l'amener a lire le document XML fourni par le QIODevice. La fonction 
setContent( ) ouvre automatiquement le peripherique si ce n'est deja fait. Nous appelons 
ensuite documentElement ( ) sur le QDomDocument pour obtenir son enfant QDomElement 
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unique, et nous verifions s'il s'agit bien d'un element <bookindex>. Nous parcourons tous 
les nceuds enfants, et si le nceud est un element <entry>, nous appelons parseEntry ( ) pour 
1' analyser. 

La classe QDomNode peut stacker tout type de nceud. Si nous souhaitons traiter un nceud de 
facon plus precise, nous devons tout d'abord le convertir en un type de donnee correct. Dans 
cet exemple, nous ne nous preoccupons que des nceuds Element. Nous appelons done toEle- 
ment() sur le QDomNode pour le convertir en un QDomElement, puis nous appelons 
tagName( ) arm de recuperer le nom de balise de l'element. Si le nceud n'est pas du type 
Element, la fonction toElement ( ) retourne un objet QDomElement nul, avec un nom de 
balise vide. 

void DomParser: :parseEntry(const QDomElement &element, 

QTreeWidgetltem *parent) 

{ 

QTreeWidgetltem *item; 
if (parent) { 

item = new QTreeWidgetltem(parent) ; 
} else { 

item = new QTreeWidgetltem(treeWidget) ; 

} 

item->setText(0, element. attribute ( "term") ) ; 

QDomNode node = element .firstChild( ) ; 
while ( !node.isNull() ) { 

if (node.toElement() .tagName() == "entry") { 

parseEntry(node.toElement( ) , item) ; 
} else if (node.toElement() .tagName() == "page") { 
QDomNode childNode = node.firstChildf) ; 
while ( IchildNode.isNullf) ) { 

if (childNode. nodeType ( ) == QDomNode: :TextNode) { 
QString page = childNode. toTextf) .data() ; 
QString allPages = item->text(1 ) ; 
if (! allPages. isEmptyO) 

allPages += " , " ; 
allPages += page; 
item->setText(1 , allPages); 
break; 

} 

childNode = childNode. nextSiblingf) ; 

} 

} 

node = node.nextSiblingf) ; 

} 

} 

Dans parseEntry ( ), nous creons un element QTreeWidget. Si elle est imbriquee dans une 
autre balise <entry>, la nouvelle balise derinit une sous-entree dans l'index, et le nouveau 
QTreeWidgetltem est cree en tant qu'enfant du QTreeWidgetltem qui represente l'entree 
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principale. Dans le cas contraire, nous creons le QTreeWidgetltem avec treeWidget en tant 
que parent, en faisant de celui-ci un element de haut niveau. Nous appelons setText ( ) pour 
definir le texte presente en colonne 0 en la valeur de l'attribut term de la balise <entry>. 

Une fois le QTreeWidgetltem initialise, nous parcourons les noeuds enfants du QDomElement 
correspondant a la balise <entry> courante. 

Si l'element est <entry>, nous appelons parseEntry ( ) avec l'element courant en tant que 
deuxieme argument. Le QTreeWidgetltem de la nouvelle entree sera alors cree avec le 
QTreeWidgetltem de l'entree principale en tant que parent. 

Si l'element est <page>, nous parcourons la liste enfant de l'element a la recherche d'un noeud 
Text. Une fois celui-ci trouve, nous appelons Text ( ) pour le convertir en un objet QDomText, 
et data ( ) pour extraire le texte en tant que QString. Puis nous ajoutons le texte a la liste de 
numeros de page delimitee par des virgules dans la colonne 1 du QTreeWidgetltem. 

Voyons comment utiliser la classe DomParser pour analyser un fichier : 

void parseFile(const QString &fileName) 
{ 

QStringList labels; 

labels « QObject: :tr("Terms") « QObject: :tr( "Pages" ) ; 

QTreeWidget *treeWidget = new QTreeWidget; 
treeWidget->setHeaderLabels (labels) ; 
treeWidget->setWindowTitle(QObject: :tr("D0M Parser")) ; 
treeWidget->show( ) ; 

QFile file(f ileName) ; 
DomParser(&f ile, treeWidget); 

} 

Nous commencons par definir un QTreeWidget. Puis nous creons un QFile et un DomParser. 
Une fois le DomParser construit, il analyse le fichier et alimente l'arborescence. 

Comme dans l'exemple precedent, nous avons besoin de la ligne suivante dans le fichier .pro 
de 1' application pour etablir un lien avec la bibliotheque QtXml : 

QT += xml 

Comme le montre l'exemple, l'operation consistant a parcourir un arbre DOM peut s'averer 
assez lourde. La simple extraction du texte entre les balises <page> et </page> a necessite le 
parcours d'une liste de QDomNode au moyen de firstChild ( ) et de nextSibling ( ). Les 
programmeurs qui utilisent beaucoup DOM ecrivent souvent leurs propres fonctions conteneur 
de haut niveau afin de simplifier les operations courantes, telles que l'extraction de texte entre 
les balises d'ouverture et de fermeture. 
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Ecrire du code XML 

Deux approches s'offrent a vous pour generer des fichiers XML a partir d' applications Qt : 

• generer un arbre DOM et appeler save ( ) sur celui-ci ; 

• generer le code XML manuellement. 

Le choix entre ces approches est souvent independant du fait que nous utilisions SAX ou DOM 
pour la lecture des documents XML. 

Voici un extrait de code qui illustre comment creer un arbre DOM et l'ecrire au moyen d'un 
QTextStream : 

const int Indent = 4; 
QDomDocument doc; 

QDomElement root = doc.createElement( "doc" ) ; 

QDomElement quote = doc. createElementf "quote" ) ; 

QDomElement translation = doc. createElementf "translation" ) ; 

QDomText latin = doc.createTextNodef'Ars longa vita brevis"); 

QDomText english = doc.createTextNode( "Art is long, life is short"); 

doc.appendChild(root) ; 

root.appendChild(quote) ; 

root.appendChild(translation) ; 

quote. appendChild(latin) ; 

translation. appendChildf english) ; 

QTextStream out(&file); 
doc.savefout, Indent); 

Le deuxieme argument de save ( ) est la faille du retrait a utiliser. Une valeur differente de zero 
facilite la lecture du contenu du fichier. Voici la sortie du fichier XML : 

<doc> 

<quote>Ars longa vita brevis</quote> 
<translation>Art is long, life is short</translation> 
</doc> 

Un autre scenario se produit dans les applications qui utilisent 1' arbre DOM comme structure 
de donnees primaire. Ces applications effectuent generalement des operations de lecture dans 
des documents XML en utilisant DOM, puis modifient 1' arbre DOM en memoire et appellent 
finalement save ( ) pour convertir de nouveau l'arbre vers XML. 

Par defaut, QDomDocument: :save() utilise l'encodage UTF-8 pour le fichier genere. Nous 
pouvons utiliser un autre encodage en ajoutant au debut de l'arbre DOM une declaration XML 
telle que : 

<?xml version="1 .0" encoding="IS0-8859-1 "?> 
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Lextrait de code suivant vous montre comment y parvenir : 
QTextStream out(&file); 

QDomNode xmlNode = doc.createProcessinglnstructionf "xml" , 

"version=\"1 .0\" encoding=\ " ISO-8859-1 \ " " ) ; 
doc. insert Bef ore (xmlNode, doc.f irstChild( ) ) ; 
doc.savefout, Indent); 

La generation manuelle de fichiers XML n'est pas beaucoup plus difficile qu'avec DOM. Nous 
pouvons employer QTextStream et ecrire les chaines comme nous le ferions avec tout autre 
fichier texte. La partie la plus delicate est de neutraliser 1' interpretation des caracteres speciaux 
qui apparaissent dans le texte et les valeurs d'attribut. La fonction Qt : : escape ( ) neutralise 
les caracteres <, > et &. Voici un extrait de code qui fait appel a cette fonction : 

QTextStream out(&file); 
out.setCodec("UTF-8"); 
out « "<doc>\n" 

« " <quote>" « Qt: :escape(quoteText) « "</quote>\n" 

« " <translation>" « Qt: :escape(translationText) 

« "</translation>\n" 

« "</doc>\n"; 

L article "Generating XML" disponible a l'adresse http://doc.trolltech.com/qq/qq05-genera- 
ting-xml.html presente une classe tres simple qui facilite la generation de fichiers XML. Cette 
classe prend en charge les details tels que les caracteres speciaux, le retrait et les problemes 
d'encodage, nous permettant de nous concentrer librement sur le code XML a generer. 
La classe a ete concue pour fonctionner avec Qt 3, mais il n'est pas difficile de 1' adapter a Qt 4. 
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Au sommaire de ce chapitre 

1/ Infobulles, informations d'etat et aide 
"Qu'est-ce que c'est ?" 

✓ UtiliserQTextBrowsercommemoteur 
d'aide simple 

Utiliser 1' Assistant Qt pour une aide 
en ligne puissante 



La plupart des applications fournissent une aide en ligne a leurs utilisateurs. Certaines 
indications apparaissent sous une forme breve, telles que les infobulles, les informations 
d'etat et "Qu'est-ce que c'est ?". Qt prend naturellement en charge toutes ces informations. 
II existe egalement un autre type d'aide, beaucoup plus approfondi, qui implique de 
nombreuses pages de texte. Dans ce cas, nous pouvons utiliser QTextBrowser en tant 
que navigateur d'aide simple. II est egalement possible d'invoquer V Assistant Qt ou un 
navigateur HTML depuis notre application. 
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Infobulles, informations d'etat et aide 
"Qu'est-ce que c'est ?" 



Une infobulle est un petit texte qui apparait lorsque la souris survole un widget. Les infobulles 
sont presentees sous la forme de texte noir sur un arriere-plan jaune. Leur objectif principal est 
de fournir des descriptions textuelles de boutons des barres d'outils. 

Nous pouvons ajouter des infobulles a des widgets arbitraires dans le code au moyen de QWid - 
get : : setToolTip ( ) . Par exemple : 

f indButton->setToolTip(tr( "Find next" ) ) ; 

Pour definir 1' infobulle d'un QAction que vous ajoutez a un menu ou a une barre d'outils, 
nous appelons simplement setToolTip ( ) sur Taction. Par exemple : 

newAction = new QAction(tr( "&New" ) , this); 
newAction->setToolTip(tr( "New document" ) ) ; 

Si nous ne definissons pas explicitement une infobulle, QAction utilise automatiquement le 
texte de Taction. 

Une information d'etat est egalement un texte descriptif bref, mais generalement un peu plus 
long que celui d'une infobulle. Lorsque la souris survole un bouton de barre d'outils ou une 
option de menu, une information d'etat apparait dans la barre d'etat. (Voir Figure 16.1) 
Appelez setStatusTip ( ) pour ajouter une information d'etat a une action ou a un widget : 

newAction->setStatusTip(tr( "Create a new document")); 



Figure 16.1 
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Dans certaines situations, il est souhaitable de fournir une information plus complete que celle 
offerte par les infobulles et les indicateurs d'etat. Nous pouvons, par exemple, afficher une 
boite de dialogue complexe contenant un texte explicatif concernant chaque champ, ceci sans 
forcer l'utilisateur a invoquer une fenetre d'aide distincte. Le mode "Qu'est-ce que c'est ?" 
represente une solution ideale dans cette situation. Quand une fenetre se trouve en mode 
"Qu'est-ce que c'est ?", le curseur se transforme en ig} et l'utilisateur peut cliquer sur tout 
composant de l'interface utilisateur pour obtenir le texte d'aide le concernant. Pour entrer en 
mode "Qu'est-ce que c'est ?", l'utilisateur peut soit cliquer sur le bouton ? dans la barre de titre 
de la fenetre (sous Windows et KDE), soit appuyer sur Ma j + F1 . 

Voici un exemple de texte "Qu'est-ce que c'est ?" : 

dialog->setWhatsThis(tr( "<img src=\ " : /images /icon. png\ ">" 

" The meaning of the Source field depends " 

"on the Type field: " 

"<ul>" 

"<li><b>Books</t» have a Publisher" 

"<li><b>Articles</b> have a Journal name with " 

"volume and issue number" 

"<li><b>Theses</b> have an Institution name " 

"and a Department name" 

"</ul>")); 

Nous pouvons utiliser les balises HTML pour mettre en forme le texte d'information d'un 
"Qu'est-ce que c'est ?". Dans l'exemple fourni, nous incluons une image (qui est reperto- 
ries dans le fichier de ressources de 1' application), une liste a puces et du texte en gras. 
(Voir Figure 16.2.) Vous trouverez les balises et attributs pris en charge par Qt a l'adresse 
http://doc.trolltech.eom/4.l/richtext-html-subset.html. 
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Un texte "Qu'est-ce que c'est ?" defini sur une action apparait quand l'utilisateur clique sur 
l'element de menu ou sur le bouton de la barre d'outils, ou encore s'il appuie sur la touche 
de raccourci alors qu'il se trouve en mode "Qu'est-ce que c'est ?".Lorsque les composants de 
1' interface utilisateur de la fenetre principale d'une application sont associes a du texte 
"Qu'est-ce que c'est ?", il est habituel de proposer une option de meme nom dans le menu 
Aide et un bouton correspondant dans la barre d'outils. Pour ce faire, il suffit de creer une 
action Qu ' est- ce que c'est ? avec la fonction statique QWhatThis : : createAction ( ) et 
d'ajouter Taction retournee a un menu Aide et a une barre d'outils. La classe QWhatsThis 
fournit des fonctions statiques destinees a programmer l'entree dans le mode "Qu'est-ce que 
c'est ?" et la sortie de ce mode. 

Utilisation de QTextBrowser comme moteur 
cTaide simple 

Les grosses applications necessitent souvent une aide en ligne plus riche que celle susceptible 
d'etre offerte pas les infobulles, les informations d'etat et le mode "Qu'est-ce que c'est ?". Une 
solution simple consiste a fournir un navigateur d'aide. Les applications incluant un navigateur 
de ce type possedent generalement une entree Aide dans le menu Aide de la fenetre principale 
ainsi qu'un bouton Aide dans chaque boite de dialogue. 

Dans cette section, nous presentons le navigateur d'aide illustre en Figure 16.3 et expliquons 
comment l'utiliser dans une application. La fenetre fait appel a QTextBrowser pour afficher 
les pages d'aide dont la syntaxe est basee sur HTML. QTextBrowser etant en mesure de gerer 
de nombreuses balises HTML, il s'avere ideal dans cette situation. 

Nous commencons par le fichier d'en-tete : 

#include <QWidget> 

class QPushButton; 
class QTextBrowser; 

class HelpBrowser : public QWidget 
{ 

Q_0BJECT 
public: 

HelpBrowser(const QString &path, const QString &page, 
QWidget *parent = 0) ; 

static void showPagefconst QString &page); 

private slots: 

void updateWindowTitle( ) ; 
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private: 

QTextBrowser *textBrowser; 
QPushButton *homeButton; 
QPushButton *backButton; 
QPushButton *closeButton; 

}; 

HelpBrowser fournit une fonction statique pouvant etre appelee n'importe oil dans l'application. 
Cette fonction cree une fenetre HelpBrowser et affiche la page donnee. 



Figure 16.3 
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Voici le debut de 1' implementation : 
#include <QtGui> 
#include "helpbrowser.h" 

HelpBrowser: :HelpBrowser(const QString &path, const QString &page, 

QWidget *parent) 

: QWidget (parent) 

{ 

setAttribute(Qt: :WA_DeleteOnClose) ; 
setAttribute(Qt: :WA_GroupLeader) ; 

textBrowser = new QTextBrowser; 

homeButton = new QPushButton(tr( "SHome" ) ) ; 
backButton = new QPushButton(tr( "&Back" ) ) ; 
closeButton = new QPushButton(tr( "Close" )) ; 
closeButton->setShortcut(tr( "Esc" ) ) ; 
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QHBoxLayout *buttonLayout = new QHBoxLayout; 
buttonLayout->addWidget (homeButton) ; 
buttonLayout->addWidget (backButton) ; 
buttonLayout->addStretch( ) ; 
buttonLayout->addWidget (closeButton) ; 

QVBoxLayout *mainLayout = new QVBoxLayout; 
mainLayout->addLayout (buttonLayout) ; 
mainLayout->addWidget (textBrowser) ; 
setLayout(mainLayout) ; 

connect (homeButton, SIGNAL(clicked( ) ) , textBrowser, SLOT(home( ) ) ) ; 
connect(backButton, SIGNAL(clicked( ) ) , 

textBrowser, SLOT ( backward ( ) ) ) ; 
connect(closeButton, SIGNAL(clicked( ) ) , this, SLOT(close( ) ) ) ; 
connect(textBrowser, SIGNAL(sourceChanged(const QUrl &) ) , 

this, SLOT(updateWindowTitle( ) ) ) ; 

textBrowser->setSearchPaths(QStringList() « path « ": /images" ) ; 
textBrowser->setSource(page) ; 

} 

Nous definissons l'attribut Qt : :WA_GroupLeader car nous souhaitons faire apparaitre les 
fenetres HelpBrowser depuis des boites de dialogue modales en complement de la fenetre 
principale. Ces boites empechent normalement l'utilisateur d'interagir avec toute autre fenetre 
de l'application. Cependant, apres avoir demande de l'aide, cet utilisateur doit de toute 
evidence etre autorise a interagir a la fois avec la boite de dialogue modale et le navigateur 
d'aide. La definition de l'attribut Qt : : WA_GroupLeader autorise cette interaction. 

Nous fournissons deux acces pour la recherche, le premier etant le systeme de fichiers conte- 
nant la documentation de l'application et le second etant 1' emplacement des ressources image. 
Le code HTML peut inclure des references aux images dans le systeme de fichiers de facon 
classique, mais il peut egalement faire reference aux ressources image en utilisant un 
chemin d' acces commencant par :/ (deux points, slash). Le parametre page est le nom du 
fichier de documentation, avec une ancre HTML facultative (une ancre HTML est la cible d'un 
lien). 

void HelpBrowser: :updateWindowTitle() 
{ 

setWindowTitle(tr( "Help: %1 " ) . arg(textBrowser->documentTitle( ) ) ) ; 

} 

Des que la page source change, le slot updateWindowTitle ( ) est appele. La fonction document- 
Title ( ) retourne le texte specifie dans la balise <title> de la page. 

void HelpBrowser: :showPage(const QString &page) 
{ 

QString path = QApplication: :applicationDirPath() + "/doc"; 
HelpBrowser *browser = new HelpBrowser(path, page); 
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browser->resize(500, 400); 
browser->show( ) ; 

} 

Dans la fonction statique showPage( ), nous creons la fenetre HelpBrowser, puis nous l'affi- 
chons. Comme nous avons defini l'attribut Qt : :WA_DeleteOnClose dans le constructeur de 
HelpBrowser, la fenetre sera detruite automatiquement lors de sa fermeture par l'utilisateur. 

Pour cet exemple, nous supposons que la documentation est stockee dans le sous-repertoire 
doc du repertoire contenant l'executable de 1' application. Toutes les pages transmises a la 
fonction showPage ( ) seront extraites de ce sous-repertoire. 

Vous etes maintenant pret a invoquer le navigateur d'aide depuis 1' application. Dans la fenetre 
principale de l'application, creez une action Aide et connectez-la a un slot help() sur le 
modele suivant : 

void MainWindow: : help { ) 
{ 

HelpBrowser: :showPage( "index.html" ) ; 

} 

Nous supposons ici que le fichier d'aide principal se nomme index.html. Dans le cas de 
boites de dialogue, vous connecteriez le bouton Aide a un slot help ( ) similaire a celui-ci : 

void EntryDialog: :help() 
{ 

HelpBrowser: :showPage("forms.html#editing") ; 

} 

Ici, nous effectuons la recherche dans un fichier d'aide different, forms . html et faisons defiler 
le QTextBrowser jusqu'a l'ancre editing. 

Utilisation de I'assistant pour une aide en ligne 
puissante 

L 'Assistant Qt est une application d'aide en ligne redistribuable fournie par Trolltech. Elle 
presente l'avantage de prendre en charge l'indexation et la recherche de texte integral et d'etre 
capable de gerer plusieurs jeux de documentation distincts correspondant a differentes applications. 

Pour utiliser V Assistant Qt, nous devons incorporer le code necessaire dans notre application et 
faire connaitre 1' existence de notre documentation a cet assistant. 

La communication entre une application Qt et I Assistant Qt est geree par la classe QAssistant- 
Client, qui est situee dans une bibliotheque distincte. Pour etablir une liaison entre cette biblio- 
theque et une application, vous devez ajouter cette ligne de code au fichier . pro de l'application : 



CONFIG += assistant 



380 Qt4 et C++ : Programmation d'interfaces GUI 



Nous allons maintenant examiner le code d'une nouvelle classe HelpBrowser qui utilise 
I 'Assistant Qt. 

#ifndef HELPBROWSER_H 
#define HELPBROWSERJH 

class QAssistantClient; 
class QString; 

class HelpBrowser 
{ 

public: 

static void showPage(const QString &page); 
private: 

static QAssistantClient *assistant; 

}; 

#endif 

Voici le nouveau fichier helpbrowser . cpp : 
#include <QApplication> 
#include <QAssistantClient> 

#include "helpbrowser. h" 

QAssistantClient *HelpBrowser: assistant = 0; 

void HelpBrowser: :showPage(const QString &page) 
{ 

QString path = QApplication : :applicationDirPath( ) + "/doc/" + page; 
if ('assistant) 

assistant = new QAssistantClient ( " " ) ; 
assistant->showPage(path) ; 

} 

Le constructeur de QAssistantClient accepte comme premier argument un chemin d'acces 
qu'il utilise pour situer l'executable de Assistant Qt. En transmettant un chemin d'acces vide, 
nous indiquons a QAssistantClient de rechercher l'executable dans la variable d'environ- 
nement PATH. QAssistantClient possede une fonction showPage( ) qui accepte un nom de 
page avec une ancre HTML en option. 

La prochaine etape consiste a preparer une table des matieres et un index pour la documenta- 
tion. Pour ce faire, nous creons un profile Assistant Qt et ecrivons un fichier . dcf qui fournit 
des informations concernant la documentation. Tout ceci est explique dans la documentation 
en ligne de I' Assistant Qt. Nous ne repeterons done pas ces indications ici. 

Une solution alternative a l'emploi de QTextBrowser ou a celui de V Assistant Qt consiste a 
s'orienter vers des approches specifiques a la plate-forme. Pour les applications Windows, il 
peut etre souhaitable de creer des fichiers d'aide HTML Windows et d'offrir un acces a ceux-ci 
par le biais de Microsoft Internet Explorer. Pour ce faire, vous pouvez recourir a la classe 
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QProcess de Qt ou a 1' infrastructure ActiveQt. L'approche la plus judicieuse pour les 
applications XI 1 serait de fournir des fichiers HTML et de lancer un navigateur Web au 
moyen de QProcess. Sous Mac OS X, l'Aide Apple fournit une fonctionnalite similaire a 
/ 'Assistant Qt. 

Nous sommes a present a la fin de la Partie II. Les chapitres de la Partie III traitent des fonc- 
tionnalites avancees et specialisees de Qt. Le code C++ et Qt presente n'est pas plus difficile 
que celui de la Partie II, mais certains concepts et idees vous paraitront peut-etre plus ardus, 
car ces domaines sont nouveaux pour vous. 
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Au sommaire de ce chapitre 

1/ Travailler avec Unicode 

1/ Creer des applications ouvertes aux 
traductions 

^ Passer dynamiquement d'une langue 
a une autre 

1/ Traduire les applications 



En complement de 1' alphabet latin utilise pour le francais et de nombreuses langues euro- 
peennes, Qt offre une large prise en charge des systemes d'ecriture du reste du monde. 

• Qt utilise Unicode en interne et par le biais de l'API. Ainsi, toutes les langues utilisees 
par 1' interface utilisateur sont prises en charge de facon identique. 

• Le moteur de texte de Qt est en mesure de gerer tous les systemes d'ecriture non- 
latins majeurs, dont l'arabe, le chinois, le cyrillique, l'hebreu, le japonais, le coreen, 
le thai et les langues Hindi. 

• Le moteur de disposition de Qt prend en charge l'ecriture de la droite vers la gauche 
pour les langues telles que l'arabe et l'hebreu. 

• Certaines langues necessitent des methodes speciales d'entree de texte. Les widgets 
d'edition tels que QLineEdit et QTextEdit fonctionnent correctement avec toute 
methode d'entree installee sur le systeme de l'utilisateur. 
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II faut souvent fournir plus qu'une simple adaptation du texte saisi par les utilisateurs dans leur 
langue native. L' interface utilisateur entiere doit egalement etre traduite. Qt facilite cette 
tache : il suffit de traiter toutes les chaines visibles par l'utilisateur avec la fonction tr() 
(comme nous l'avons fait dans les chapitres precedents) et d'utiliser les outils de prise en 
charge de Qt pour preparer la traduction des fichiers dans les langues requises. Qt fournit un 
outil GUI nomme Qt Linguist destine a etre utilise par les traducteurs. Qt Linguist est complete 
par deux programmes de ligne de commande, lupdate et lrelease, qui sont generalement 
executes par les developpeurs de 1' application. 

Pour la plupart des applications, un fichier de traduction est charge au demarrage qui tient 
compte des parametres locaux de l'utilisateur. Mais dans certains cas, il est egalement necessaire de 
pouvoir basculer d'une langue a 1' autre au moment de 1' execution. Ceci est parfaitement possi- 
ble avec Qt, bien que cette operation implique un travail supplementaire. Et grace au systeme 
de disposition de Qt, les divers composants de 1' interface utilisateur sont automatiquement 
ajustes pour faire de la place aux textes traduits quand ils sont plus longs que les originaux. 



Travailler avec Unicode 

Unicode est un systeme de codage de caracteres qui prend en charge la plupart des systemes 
d'ecriture mondiaux. L'idee a l'origine du developpement d'Unicode est qu'en utilisant 16 bits 
au lieu de 8 pour stacker les caracteres, il devient possible de coder environ 65 000 caracteres 
au lieu de 256 1 . Unicode comprend les systemes ASCII et ISO 8859-1 (Latin-1) et ces deux 
sous-ensembles se trouvent sur les memes positions de code. La valeur du caractere "A", par 
exemple, est de 0x41 dans les systemes ASCII, Latin-1 et Unicode et celle de "A" est de OxDl 
dans les systemes Latin-1 et Unicode. 

La classe QString de Qt stocke les chaines utilisant le systeme Unicode. Chaque caractere 
d'un QString est un QChar de 16 bits et non un char de 8 bits. Voici deux methodes pour 
definir le premier caractere d'une chaine en "A" : 

str[0] = 'A'; 

str[0] = QChar(0x41); 

Si le fichier source est code en Latin-1, il est aise de specifier des caracteres en Latin-1 : 

str[0] = ' N ' ; 

Et si le codage du fichier source est different, la valeur numerique fonctionne bien : 
str[0] = QChar(0xD1); 



1. Les versions recentes d'Unicode affectent des valeurs de caracteres au-dessus de 65 535. Ces caracteres 
peuvent etre represented avec des sequences de deux valeurs de 16 bits nominees "paires de substitution". 
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Nous pouvons designer tout caractere Unicode par sa valeur numerique. Voici, par exemple, 
comment specifier la lettre grecque majuscule sigma ("E") et le caractere monetaire euro ("€"). 

str[0] = QChar(0x3A3) ; 
str[0] = QChar(0x20AC) ; 

Les valeurs numeriques de tous les caracteres pris en charge par Unicode sont repertoriees a 
l'adresse http://www.unicode.org/standard/. Si votre besoin en caracteres Unicode non- 
Latin- 1 est rare et ponctuel, la recherche en ligne est la solution appropriee. Qt fournit cependant 
des moyens plus pratiques d'entrer des chaines Unicode dans un programme, comme nous le 
verrons ulterieurement dans cette section. 

Le moteur de texte de Qt4 prend en charge les systemes d'ecriture suivants sur toutes les 
plates-formes : arabe, chinois, cyrillique, grec, hebreu, japonais, coreen, lao, latin, thai et viet- 
namien. II prend aussi en charge tous les scripts Unicode 4. 1 ne necessitant pas de traitement 
special. En outre, les systemes d'ecriture suivants sont pris en charge sur XI 1 avec Fonconfig 
et sur les versions recentes de Windows : bengali, devanagari, gujarati, gurmukhi, kannada, 
khmer, malayalam, syriac, tamil, telugu, thaana (dhivehi) et tibetain. Loriya, enfin, est pris en 
charge sur XI 1 et le mongolien ainsi que le sinhala sont pris en charge par Windows XP. 
En supposant que les polices correctes sont installees sur le systeme, Qt peut afhcher le texte 
au moyen de ces systemes d'ecriture. Et en supposant que les methodes d' entree correctes sont 
installees, les utilisateurs pourront entrer du texte correspondant a ces systemes d'ecriture dans 
leurs applications Qt. 

La programmation avec QChar differe legerement de celle avec char. Pour obtenir la valeur 
numerique d'un QChar, vous devez appeler Unicode () sur celui-ci. Pour obtenir la valeur 
ASCII ou Latin-1 d'un QChar, il vous faut appeler toLatinl (). Pour les caracteres non- 
Latin-1, toLatinl ( ) retourne "\0". 

Si nous savons que toutes les chaines d'un programme appartiennent au systeme ASCII, nous 
pouvons utiliser des fonctions <cctype> standard telles que isalpha(), isdigit() et 
isspace ( ) sur la valeur de retour de toLatinl ( ). II est cependant generalement preferable 
de faire appel aux fonctions membre de QChar pour realiser ces operations, car elles fonction- 
neront pour tout caractere Unicode. Les fonctions fournies par QChar incluent isPrint(), 
isPunct(), isSpace(), isMark(), isLetter(), isNumber(), isLetterOrNumber ( ), 
isDigit ( ), isSymbol( ), isLower ( ) et isUpper ( ). Voici, par exemple, un moyen de tester 
si un caractere est un chiffre ou une lettre majuscule : 

if (ch.isDigit() || ch.isupper()) 

L'extrait de code fonctionne pour tout alphabet qui distingue les majuscules des minuscules, 
dont 1' alphabet latin, grec et cyrillique. 

Lorsque vous avez une chaine Unicode, vous pouvez l'utiliser a tout emplacement de 1' API de 
Qt ou est attendu un QString. Qt prend alors la responsabilite de l'afficher correctement et 
de la convertir en codages adequats pour le systeme d' exploitation. 
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Nous devons etre particulierement attentifs lorsque nous lisons ou ecrivons des fichiers texte. 
Ces derniers peuvent utiliser plusieurs codages, et il est souvent impossible de deviner le 
codage d'un fichier de ce type a partir de son contenu. Par defaut, QTextStream utilise le codage 
8 bits local du systeme pour la lecture et l'ecriture. Pour les Etats-Unis et l'Europe de l'ouest, 
il s'agit habituellement de Latin- 1. 

Si nous concevons notre propre format de fichier et souhaitons etre en mesure de lire et d'ecrire 
des caracteres Unicode arbitrages, nous pouvons enregistrer les donnees sous la forme Unicode 
en appelant 

stream. setCodec( "UTF-16" ) ; 

st ream. setGenerateByteOrderMark( true) ; 

avant de commencer l'ecriture dans le QTextStream. Les donnees seront alors enregistrees au 
format UTF-16, format qui necessite deux octets par caractere, et seront prefixees par une 
valeur speciale de 16 bits (la marque d'ordre d'octet Unicode, OxFFFE) indiquant si ce fichier 
est en Unicode et si les octets se trouvent dans l'ordre little-endian ou big-endian. Le format 
UTF-16 etant identique a la representation memoire d'un QString, la lecture et l'ecriture de 
chaines Unicode dans ce format peut etre tres rapide. II se produit cependant une surcharge lors 
de l'enregistrement de donnees ASCII pures au format UTF-16, car deux octets sont stockes 
pour chaque caractere au lieu d'un seul. 

II est possible de mentionner d'autres codage en appelant setCodec ( ) avec un QTextCodec 
approprie. Un QTextCodec est un objet qui effectue une conversion entre Unicode et un 
codage donne. Les QTextCodec sont employes dans differents contextes par Qt. En interne, ils 
sont utilises pour la prise en charge des polices, des methodes d'entree, du presse-papiers, des 
operations de glisser-deposer et des noms de fichiers. Mais ils sont egalement utiles pour 
l'ecriture d' applications Qt. 

Lors de la lecture d'un fichier texte, QTextStream detecte Unicode automatiquement si le 
fichier debute par une marque d'ordre d'octet. Ce comportement peut etre desactive en appe- 
lant setAutoDetectUnicode (false). Si les donnees ne sont pas supposees commencer par la 
marque d'ordre d'octet, il est preferable d'appeler setCodec ( ) avec "UTF-16" avant la lecture. 

UTF-8 est un autre codage qui prend en charge la totalite du systeme Unicode. Son principal 
avantage par rapport a UTF-16 est qu'il s'agit d'un super ensemble ASCII. Tout caractere se 
situant dans la plage 0x00 a 0x7F est represents par un seul octet. Les autres caracteres, dont 
les caracteres Latin-1 au-dessus de 0x7F, sont represented par des sequences multi-octets. Pour 
ce qui est du texte en majorite ASCII, UTF-8 occupe environ la moitie de l'espace consomme 
par UTF-16. Pour utiliser UTF-8 avec QTextStream, appelez setCodec () avec "UTF-8" 
comme nom de codec avant les operations de lecture et d'ecriture. 

Si nous souhaitons toujours lire et ecrire en Latin-1 sans tenir compte du systeme de codage 
local de l'utilisateur, nous pouvons definir le codec "ISO 8859-1" sur QTextStream. 
Par exemple : 

QTextStream in(&f ile) ; 
in. setCodec ( "ISO 8859-1"); 
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Certains formats de richiers specifient leur codage dans leur en-tete. L'en-tete est generalement 
en ASCII brut pour assurer une lecture correcte quel que soit le codage utilise. Le format de 
fichier XML en est un exemple interessant. Les fichiers XML sont normalement encodes sous 
la forme UTF-8 ou UTF-16. Pour les lire correctement, il faut appeler setCodec() avec 
"UTF-8".Si le format est UTF-16, QTextStream le detectera automatiquement et s'adaptera. 
L'en-tete <?xml?> d'un fichier XML contient quelquefois un argument encoding. Par exemple : 

<?xml version="1 .0" encoding="EUC-KR"?> 

Comme QTextStream ne vous permet pas de changer le codage une fois la lecture commen- 
cee, la meilleure facon d'appliquer un codage explicite consiste a recommencer a lire le fichier, 
en utilisant le codec correct (obtenu a l'aide de QTextCodec : : codecForName ( )). Dans le cas 
de XML, nous pouvons eviter d'avoir a gerer le codage nous-memes en utilisant les classes 
XML de Qt decrites dans le Chapitre 15. 

Les QTextCodec peuvent egalement etre employes pour specifier le codage de chaines dans le 
code source. Considerons, par exemple, une equipe de programmeurs japonais ecrivant une 
application destinee principalement au marche des particuliers. II est probable que ces 
programmeurs ecrivent leur code source dans un editeur de texte qui utilise un codage tel que 
EUC-JP ou Shift- JIS. Un editeur de ce type leur permet de saisir des caracteres japonais sans 
probleme. lis peuvent done ecrire le type de code suivant : 

QPushButton "button = new QPushButton(tr( " Big" ) ) ; 

Par defaut, Qt interprete les arguments de tr ( ) comme Latin- 1. Pour les autres cas, nous appelons 
la fonction statique QTextCodec : : setCodecForTr( ). Par exemple : 

QTextCodec: :setCodecForTr(QTextCodec: : codecForName ( "EUC-JP" ) ) ; 

Cette operation doit etre effectuee avant le premier appel a t r ( ) . En general, elle est realisee 
dans main ( ) , immediatement apres la creation de l'objet QApplication. 

Les autres chaines specifiees dans le programme seront interpreters comme des chaines Latin- 
1. Si les programmeurs souhaitent y entrer egalement des caracteres japonais, ils peuvent les 
convertir explicite ment en Unicode au moyen d'un QTextCodec : 

QString text = japaneseCodec->toUnicode( " MM$\M" ) ', 

Ils peuvent alternativement demander a Qt de faire appel a un codec specifique lors de la 
conversion entre const char* et QString en appelant QTextCodec :: setCodec- 
ForCStrings( ) : 

QTextCodec : : setCodecForCSt rings (QTextCodec : : codecForName ( " EUC-JP" ) ) ; 

Les techniques decrites ci-dessus peuvent etre appliquees a toute langue non Latin- 1, dont le 
chinois, le grec, le coreen et le russe. 
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Voici une liste des codages pris en charge par Qt 4 : 



• Apple Roman 


• ISO 8859-5 


• Iscii-Mlm 


• UTF-8 


• Big5 


• ISO 8859-6 


• Iscii-Ori 


• UTF-16 


• Big5-HKSCS 


• ISO 8859-7 


• Iscii-Pnj 


• UTF-16BE 


• EUC-JP 


• ISO 8859-8 


• Iscii-Tlg 


• UTF-16LE 


• EUC-KR 


• ISO 8859-9 


• Iscii-Tml 


• Windows- 1250 


• GB 18030-0 


• ISO 8859-10 


• JIS X0201 


• Windows- 1251 


• IBM 850 


• ISO 8859-13 


• JIS X 0208 


• Windows- 125 2 


• IBM 866 


• ISO 8859-14 


• KOI8-R 


• Windows-1253 


• IBM 874 


• ISO 8859-15 


• KOI8-U 


• Windows- 1254 


• ISO 2022- JP 


• ISO 8859-16 


• MuleLao-1 


• Windows- 1255 


• ISO 8859-1 


• Iscii-Bng 


• ROMAN8 


• Windows- 125 6 


• ISO 8859-2 


• Iscii-Dev 


• Shift-JIS 


• Windows- 1257 


• ISO 8859-3 


• Iscii-Gjr 


• TIS-620 


• Windows- 125 8 


• ISO 8859-4 


• Iscii-Knd 


• TSCII 


• WINSAMI2 



Pour tous ces codages, QTextCodex : : codecForName ( ) retournera toujours un pointeur 
valide. Les autres codages peuvent etre pris en charge en derivant QTextCodec. 



Creer des applications ouvertes aux traductions 

Pour que nos applications soient disponibles dans plusieurs langues, il convient de veiller a 
deux points : 

• S'assurer que chaque chaine visible par l'utilisateur passe par tr ( ) . 

• Charger un fichier de traduction ( . qm) au demarrage. 

Aucune de ces operations n'est necessaire pour les applications qui ne seront jamais traduites. 
Mais l'emploi de t r ( ) ne necessite pratiquement aucun effort et laisse la porte ouverte a toute 
traduction ulterieure. 

tr() est une fonction statique definie dans QObject et remplacee dans chaque sous-classe 
definie avec la macro Q_0BJECT. Lorsque nous ecrivons du code dans une sous-classe QObject, 
nous pouvons appeler t r ( ) sans formalite. Un appel a t r ( ) retourne une traduction si elle est 
disponible. Dans le cas contraire, le texte original est retourne. 
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Pour preparer les fichiers de traduction, nous devons executer l'outil lupdate de Qt. Cet outil 
extrait tous les litteraux de chaine qui apparaissent dans les appels de t r ( ) et produit des 
fichiers de traduction qui contiennent toutes les chaines pretes a etre traduites. Les fichiers 
peuvent alors etre expedies a un traducteur afin qu'il y ajoute les traductions. Ce processus est 
explique dans la section "Traduction d' application" un peu plus loin dans ce chapitre. 

La syntaxe d'un appel de t r ( ) est la suivante : 

Context: :tr(sourceText, comment) 

La partie Context est le nom d'une sous-classe QObject definie avec la macro Q_OBJECT. 
II n'est pas necessaire de lui preciser si nous appelons tr ( ) depuis une fonction membre de la 
classe en question. La partie sourceText est le litteral chaine a traduire. La partie comment 
est facultative. Elle permet de fournir des informations supplementaires au traducteur. 

Voici quelques exemples : 

RockyWidget: :RockyWidget(QWidget *parent) 
: QWidget( parent) 

{ 

QString stM = tr( "Letter" ) ; 

QString str2 = RockyWidget: :tr( "Letter" ) ; 

QString str3 = SnazzyDialog : :tr( "Letter" ) ; 

QString str4 = SnazzyDialog : :tr( "Letter" , "US paper size"); 

} 

Le contexte des deux premiers appels a tr ( ) est "RockyWidget" et celui des deux derniers 
appels est "SnazzyDialog". "Letter" est le texte source des quatre appels. Le dernier d'entre eux 
comporte egalement un commentaire destine a aider le traducteur a comprendre le sens du 
texte source. 

Dans des contextes differents, les chaines sont traduites independamment les unes des autres. 
Les traducteurs travaillent generalement sur un seul contexte a la fois, sou vent avec 1' application 
en cours d' execution et en affichant la boite de dialogue ou le widget soumis a la traduction. 

Lorsque nous appelons tr() depuis une fonction globale, nous devons specifier le contexte 
explicitement. Toute sous-classe QObject de l'application peut etre employee en tant que 
contexte. Si aucun contexte n'est approprie, il est toujours possible de recourir a QOb j ect lui- 
meme. Par exemple : 

int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 

QPushButton button(QObject: :tr( "Hello Qt!")); 
button. show() ; 
return app.execf) ; 

} 

Dans tous les exemples etudies jusqu'a present, le contexte etait celui d'un nom de classe. 
C'est pratique, car nous pouvons presque toujours l'omettre, mais ce n'est pas une obligation. 
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La facon la plus courante de traduire une chaine en Qt consiste a utiliser la fonction QAppli- 
cation : : translate ( ), qui accepte jusqu'a trois arguments : le contexte, le texte source et le 
commentaire facultatif. Voici, par exemple, une autre facon de traduire "Hello Qt !": 

QApplication: :translate( "Global Stuff", "Hello Qt!") 

Ici, nous placons le texte dans le contexte "Global Stuff. 

L usage des fonctions tr ( ) et translate ( ) est double : elles remplissent a la fois le role des 
marqueurs utilises par lupdate pour trouver les chaines visibles par l'utilisateur, et elles agis- 
sent en tant que fonctions C++ qui traduisent du texte. Cette caracteristique a un impact sur la 
facon dont nous ecrivons le code. Les lignes suivantes, par exemple, ne fonctionneront pas : 

// INCORRECT 

const char *appName = "OpenDrawer 2D"; 
QString translated = tr(appName); 

Le probleme ici est que lupdate ne sera pas en mesure d'extraire le litteral chaine "Open- 
Drawer 2D", car il n'apparait pas a l'interieur d'un appel t r ( ) . Le traducteur n'aura done pas 
la possibilite de traduire la chaine. Ce probleme se pose souvent avec les chaines dynamiques : 

// INCORRECT 

statusBar()->showMessage(tr("Host " + hostName + " found")); 

Ici, la chaine que nous transmettons a tr ( ) varie en fonction de la valeur de hostName, de sorte 
que nous ne pouvons pas raisonnablement nous attendre a ce que t r ( ) la traduise correctement. 

La solution consiste a executer QString: :arg() : 

statusBar()->showMessage(tr("Host %1 found" ) .arg( hostName) ) ; 

Ce code repose sur le principe suivant : le litteral chaine "Host %\ found" est transmis a tr ( ) . 
En supposant qu'un fichier de traduction en francais est charge, tr( ) retournera quelque chose 
comme "Hote %1 trouve".Puis le parametre "%1" est remplace par le contenu de la variable 
hostName. 

Bien qu'il soit generalement deconseille d'appeler tr() sur une variable, il est possible de 
faire fonctionner cette technique correctement. Nous devons utiliser la macro QT_TR_N00P ( ) 
arm de marquer les litteraux chaine a traduire avant de les affecter a une variable. Cette 
methode se revele particulierement interessante pour les tableaux statiques de chaines. Par 
exemple : 

void OrderForm: :init() 
{ 

static const char * const flowers [] = { 
QT_TR_N00P( "Medium Stem Pink Roses"), 
QT_TR_N00P( "One Dozen Boxed Roses"), 
QT_TR_N00P( "Calypso Orchid"), 
QT_TR_N00P( "Dried Red Rose Bouquet"), 
QT_TR_N00P( "Mixed Peonies Bouquet"), 
0 
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}; 

for (int i = 0; flowers[i]; ++i) 
comboBox->addItem(tr(flowers[i] ) ) ; 

} 

La macro QT_TR_N00P() retoume simplement son argument. Mais lupdate extraira toutes 
les chaines encadrees par cette derniere afin qu'elles puissent etre traduites. Par la suite, au 
moment d'utiliser la variable, nous appellerons normalement tr( ). Meme si elle recoit une 
variable, cette f onction remplit correctement son role de traduction. 

La macro QT_TRANSLATE_NOOP ( ) fonctionne comme QT_TR_N00P( ) a la difference qu'elle 
recoit aussi un contexte. Cette macro est pratique pour initialiser des variables a l'exterieur 
d'une classe : 

static const char * const flowers[] = { 

QT_TRANSLATE_NOOP( "OrderForm" , "Medium Stem Pink Roses"), 
QT_TRANSLATE_NOOP( "OrderForm" , "One Dozen Boxed Roses"), 
QT_TRANSLATE_NOOP( "OrderForm" , "Calypso Orchid"), 
QT_TRANSLATE_NOOP( "OrderForm" , "Dried Red Rose Bouquet"), 
QT_TRANSLATE_NOOP( "OrderForm" , "Mixed Peonies Bouquet"), 
0 

}; 

L argument de contexte doit etre identique au contexte fourni ulterieurement a t r ( ) ou a 
translate( ). 

Lorsque nous commencons a utiliser tr ( ) dans une application, le risque est grand d'oublier 
d'inserer des chaines visibles par l'utilisateur dans un appel de cette fonction. Si ces appels 
manquants ne sont pas detectes par le traducteur, les utilisateurs de 1' application vont voir 
apparaitre certaines chaines dans la langue originale. Pour eviter ce probleme, nous pouvons 
demander a Qt d'interdire les conversions implicites de const char* en QString. Pour ce 
faire, nous definissons le symbole de preprocesseur QT_NO_CAST_FROM_ASCI I avant d'inclure 
tout en-tete Qt. Le moyen le plus facile de s'assurer que ce symbole est defini consiste a ajouter 
la ligne suivante au fichier . pro de 1' application : 

DEFINES += QT_NO_CAST_FROM_ASCII 

Chaque litteral chaine devra ainsi etre obligatoirement traite par tr( ) ou QLatinlString ( ), 
selon qu'il devra etre traduit ou non. Les chaines qui ne seront pas encadrees par ces fonctions 
vont ainsi generer une erreur a la compilation, et il ne vous restera plus qu'a ajouter les appels 
de tr ( ) ou QLatinlString ( ) manquants. 

Une fois chaque chaine visible par l'utilisateur inseree dans un appel de tr ( ), il ne reste plus 
qu'a charger un fichier de traduction. L' operation se deroule generalement dans la fonction 
main ( ) de l'application. Voici, par exemple, comment nous chargerions un fichier de traduction 
base sur les parametres locaux de l'utilisateur : 

int mainfint argc, char *argv[]) 
{ 
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QApplication app(argc, argv); 
QTranslator appTranslator; 

appTranslator.load( "myapp_" + QLocale: :system() .name(), 

qApp->applicationDirPath ( ) ) ; 
app.installTranslatorf&appTranslator) ; 

return app.exec() ; 

} 

La fonction QLocale: : System () retourne un objet QLocale qui fournit des informations 
concernant les parametres locaux de l'utilisateur. Par convention, nous integrons le nom des 
parametres locaux au nom du fichier . qm. Ces noms peuvent etre plus ou moins precis : f r, par 
exemple, indique des parametres locaux en langue frangaise, f r_CA represente des parametres 
locaux en frangais canadien et f r_CA. IS08859-15 en frangais canadien avec du codage ISO 
8859-15 (un codage qui prend en charge "CE" et "oe"). 

En supposant que les parametres locaux soient en f r_CA. IS08859-15, la fonction QTrans- 
lator: :load() essaie tout d'abord de charger le fichier myapp_f r_CA. IS08859- 1 5 . qm. 
Si le fichier n'existe pas, load() essaie ensuite myapp_f r_CA. qm, puis myapp_fr.qm et 
enfin myapp.qm avant d'abandonner. Nous ne fournissons normalement qu'un fichier 
myapp_fr.qm, contenant une traduction en frangais standard, mais si nous souhaitons un 
fichier different pour le frangais canadien, nous pouvons aussi fournir un fichier myapp_f r_CA . qm 
qui sera utilise pour les parametres locaux f r_CA . 

Le deuxieme argument de QTranslator: :load() est le repertoire oil nous souhaitons que 
load ( ) recherche le fichier de traduction. Dans ce cas, nous supposons que les fichiers de 
traduction sont situes dans le me me repertoire que 1' executable. 

Les bibliotheques Qt contiennent quelques chaines necessitant une traduction. Trolltech fournit 
des traductions en frangais, en allemand et en chinois simplifie dans le repertoire trans- 
lations de Qt. Quelques autres langues sont egalement fournies, mais par les utilisateurs Qt. 
lis ne sont pas officiellement pris en charge. Le fichier de traduction des bibliotheques Qt doit 
egalement etre charge. 

QTranslator qtTranslator; 

qtTranslator.load( "qt_" + QLocale: :system() .name() , 

qApp->applicationDirPath( ) ) ; 
app.installTranslator(&qtTranslator) ; 

Un objet QTranslator ne peut contenir qu'un seul fichier de traduction a la fois. C'est pour- 
quoi nous utilisons un QTranslator distinct pour la traduction de Qt. Cela ne presente aucun 
probleme puisque nous pouvons installer autant de traducteurs que necessaire. QApplication 
les utilisera tous lors de la recherche d'une traduction. 

Certaines langues, telles que l'arabe et l'hebreu, sont ecrites de droite a gauche au lieu de 
gauche a droite. Dans cette situation, la mise en forme complete de 1' application doit etre 
inversee en appelant QApplication :: setLayoutDirection ( Qt: :RightToLeft). Les 
fichiers de traduction de Qt contiennent un marqueur special nomme "LTR" qui indique si la 
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langue s'ecrit de gauche a droite ou de droite a gauche. Nous n'avons done generalement pas 
besoin d'appeler setLayoutDirection ( ). 

II serait plus pratique pour les utilisateurs de fournir les applications avec les fichiers de traduction 
integres a 1' executable, en utilisant le systeme de ressource de Qt. Cette technique permettrait 
non seulement de reduire le nombre de fichiers distribues pour constituer le produit, mais aussi 
d'eviter le risque de perte ou de suppression accidentelle de fichiers de traduction. 

En supposant que les fichiers . qm sont situes dans un sous -repertoire translations se trouvant 
dans l'arbre source, nous aurions alors un fichier myapp . qrc avec le contenu suivant : 

<!D0CTYPE RCC><RCC version=" 1 .0"> 
<qresource> 

<f ile>translations/myapp_de.qm</f ile> 

<file>translations/myapp_f r .qm</f ile> 

<f ile>translations/myapp_zh .qm</f ile> 

<f ile>translations/qt_de . qm</f ile> 

<f ile>translations/qt_f r.qm</f ile> 

<f ile>translations/qt_zh . qm</f ile> 
</qresource> 
</RCC> 

Le fichier .pro contiendrait 1' entree suivante : 

RESOURCES = myapp. qrc 

Nous devons enfin specifier : /translations comme chemin d'acces aux fichiers de traduction 
dans main ( ). Les deux points qui apparaissent en premiere position indiquent que le chemin 
d'acces fait reference a une ressource et non a un fichier situe dans le systeme de fichiers. 

Nous avons maintenant etudie tous les points necessaires pour permettre a une application de 
fonctionner en utilisant des traductions dans d'autres langues. Mais la langue et la direction du 
systeme d'ecriture ne sont pas les seuls points variables entre differents pays et cultures. Un 
programme internationalise doit egalement prendre en compte les formats de date, d'heure, 
monetaire, numerique et l'ordre de classement des chaines. Qt inclut une classe QLocale qui 
fournit des formats de date/d'heure et numerique localises. Pour obtenir d'autres informations 
locales, nous pouvons faire appel aux fonctions C++ setlocale ( ) et localeconv ( ). 

Certaines classes et fonctions de Qt adaptent leur comportement en fonction des parametres 
locaux : 

• QString : : localeAwareCompare ( ) compare deux chaines en prenant en compte les 
parametres locaux. Elle permet de trier les elements visibles par l'utilisateur. 

• La fonction toString() fournie par QDate, QTime et QDateTime retourne une chaine 
dans un format local quand elle est appelee avec Qt: :LocalDate comme argument. 

• Par defaut, les widgets QDateEdit et QDateTimeEdit presentent les dates dans le format 
local. 

Enfin, il est possible qu'une application traduite ait besoin d'utiliser des icones differentes de 
celles fournies initialement. Par exemple, les fleches gauche et droite apparaissant sur les 
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boutons Precedente et Suivante d'un navigateur Web doivent etre inversees dans le cas 
d'une langue s'ecrivant de droite a gauche. Voici comment proceder : 

if (QApplication: :isRightToLeft()) { 

backAction->set Icon (forward I con) ; 

f orwardAct ion- >set Icon (backl con) ; 
} else { 

backAction->setIcon(backIcon) ; 

forwardAction->setIcon(forwardIcon) ; 

} 

Les icones contenant des caracteres alphabetiques doivent tres souvent etre traduites. Par 
exemple, la lettre "I" qui apparait sur un bouton de barre d'outils associe a une option Itali- 
que d'un traitement de texte doit etre remplacee par un "C" en espagnol (Cursivo) et par un 
"K" en danois, neerlandais, allemand, norvegien et suedois (Kursiv). Voici un moyen simple 
d'y parvenir : 

if (tr("ltalic")[0] == 'C') { 

italicAction->setIcon(iconC) ; 
} else if (tr("ltalic")[0] == 'K') { 

italicAction->setIcon(iconK) ; 
} else { 

italicAction->setIcon(iconI) ; 

} 

Une alternative consiste a utiliser la prise en charge de multiples parametres locaux de la part 
du systeme de ressource. Dans le fichier . qrc, il est possible de specifier un parametre regional 
pour une ressource au moyen de l'attribut lang. Par exemple : 

<qresource> 

<f ile>italic . png</f ile> 
</qresource> 
<qresource lang="es"> 

<f ile alias= " italic . png " >cursivo . png</f ile> 
</qresource> 
<qresource lang="sv"> 

<f ile alias= "italic. png ">kursiv.png</file> 
</qresource> 

Si le parametre local de l'utilisateur est es (Espanol), :/ italic. png fait alors reference a 
l'image cursivo . png. Si le parametre local est sv (Svenska), c'est l'image kursiv . png qui 
est employee. Pour d'autres parametres locaux, italic . png est utilise. 

Passer dynamiquement d'une langue a une autre 

Pour la plupart des applications, la detection de la langue preferee de l'utilisateur dans main ( ) 
et le chargement des fichiers . qm appropries donne un resultat satisfaisant. Mais il existe des 
situations dans lesquelles les utilisateurs doivent pouvoir basculer dynamiquement d'une 
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langue a 1' autre. Un changement de langue sans redemarrage peut etre necessaire pour une 
application employee en permanence par differentes personnes. Par exemple, les applications 
employees par les operateurs de centres d'appels, par des traducteurs simultanes et par des 
operateurs de caisses enregistreuses informatisees requierent souvent cette possibilite. 

Le passage dynamique d'une langue a une autre est un peu plus complexe a programmer que le 
chargement d'une traduction unique au lancement de 1' application, mais ce n'est pas tres diffi- 
cile. Voici comment proceder : 

• Vous devez offrir a l'utilisateur le moyen de passer a une autre langue. 

• Pour chaque widget ou boite de dialogue, vous devez definir toutes les chaines susceptibles 
d'etre traduites dans une fonction distincte (souvent nominee retranslateUi( )) et appeler 
cette fonction lors des changements de langue. 

Examinons les segments les plus importants du code source d'une application "centre 
d'appel".L' application fournit un menu Language permettant a l'utilisateur de definir la 
langue au moment de l'execution. La langue par defaut est l'anglais. (Voir Figure 17.1) 



Fi § ure 171 | Language 

Un menu Language 

dynamique 



1 

2 Deutsch 

3 English 

4 Franqais 

5 Jl'-QiJ 



Comme nous ne savons pas quelle langue l'utilisateur souhaite employer au lancement de 
1' application, nous ne chargeons pas de traduction dans la fonction main(). Nous les char- 
geons plutot dynamiquement quand elles s'averent necessaires. Ainsi, tout le code dont nous 
avons besoin pour gerer les traductions doit etre place dans les classes des boites de dialogue et 
de la fenetre principale. 

Examinons la sous-classe QMainWindow de 1' application. 

MainWindow: :MainWindow( ) 
{ 

journalView = new JournalView; 
setCentralWidget(journalView) ; 

qApp->installTranslator(&appTranslator) ; 

qApp->installTranslator(&qtTranslator) ; 

qmPath = qApp->applicationDirPath() + "/translations"; 

createActions( ) ; 
createMenus() ; 

retranslateUi( ) ; 

} 
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Dans le constructeur, nous definissons le widget central en tant que JournalView, une sous- 
classe de QTableWidget. Puis nous definissons quelques variables membre privees en liaison 
avec la traduction : 

• La variable appTranslator est un objet QTranslator utilise pour stacker la traduction 
de P application en cours. 

• La variable qtTranslator est un objet QTranslator utilise pour stacker la traduction de Qt. 

• La variable qmPath est un QString qui specifie le chemin d'acces au repertoire contenant 
les fichiers de traduction de Papplication. 

Nous appelons enfin les fonctions privees createActions ( ) et createMenus ( ) pourcreerle 
systeme de menus, et nous appelons retranslateUi( ), egalement une fonction privee, pour 
definir les chaines initialement visibles par Putilisateur : 

void MainWindow: :createActions() 
{ 

newAction = new QAction(this) ; 

connect (newAction, SIGNAL(triggered( ) ) , this, SLOT(newFile( ) ) ) ; 
aboutQtAction = new QAction(this) ; 

connect (aboutQtAction, SIGNAL(triggered( ) ) , qApp, SLOT(aboutQt( ) ) ) ; 

} 

La fonction createActions ( ) cree normalement ses objets QAction, mais sans definir aucun 
texte ou touche de raccourci. Ces operations seront effectuees dans retranslateUi ( ) . 

void MainWindow: :createMenus() 
{ 

fileMenu = new QMenu(this); 
fileMenu->addAction(newAction) ; 
f ileMenu->addAction(openAction) ; 
f ileMenu->addAction(saveAction) ; 
f ileMenu->addAction(exitAction) ; 

createLanguageMenu( ) ; 

helpMenu = new QMenu(this) ; 
helpMenu->addAction(aboutAction) ; 
helpMenu->addAction( aboutQtAction) ; 

menuBar()->addMenu(fileMenu) ; 
menuBar()->addMenu(editMenu) ; 
menuBar( )->addMenu( report sMenu) ; 
menuBar( )->addMenu(languageMenu) ; 
menuBar()->addMenu(helpMenu) ; 

} 

La fonction createMenus ( ) cree des menus, mais ne leur affecte aucun titre. Une fois encore, 
cette operation sera effectuee dans retranslateUi(). 
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Au milieu de la fonction, nous appelons createLanguageMenu ( ) pour remplir le menu 
Language avec la liste des langues prises en charge. Nous reviendrons sur son code source 
dans un moment. Examinons tout d'abord retranslateUi( ) : 

void MainWindow: : retranslateUi( ) 
{ 

newAction->setText(tr( "&New" ) ) ; 
newAction->setShortcut (tr( "Ctrl+N" ) ) ; 
newAction->setStatusTip(tr( "Create a new journal")); 

aboutQtAction->setText(tr( "About &Qt" ) ) ; 

aboutQtAction->setStatusTip(tr( "Show the Qt library's About box")); 

f ileMenu->setTitle(tr( "&File" ) ) ; 
editMenu->setTitle(tr( "&Edit " ) ) ; 
reportsMenu->setTitle(tr( "&Reports" ) ) ; 
languageMenu->setTitle(tr( "&Language" ) ) ; 
helpMenu->setTitle(tr( "&Help" ) ) ; 
setWindowTitle(tr( "Call Center" ) ) ; 

} 

C'est dans la fonction retranslateUi ( ) que se produisent tous les appels de tr( ) pour la 
classe MainWindow. Ces appels ont lieu a la fin du constructeur de MainWindow et a chaque 
fois qu'un utilisateur change la langue de l'application par le biais du menu Language. 

Nous definissons chaque texte, touche de raccourci et information d'etat de QAction. Nous 
definissons egalement chaque titre de QMenu ainsi que le titre de fenetre. 

La fonction createMenus ( ) presentee precedemment a appele createLanguageMenu ( ) 
pour remplir le menu Language avec une liste de langues : 

void MainWindow: : createLanguageMenu () 
{ 

languageMenu = new QMenu(this); 

languageActionGroup = new QActionGroup(this) ; 
connectflanguageActionGroup, SIGNAL(triggered(QAction *)), 
this, SLOT(switchLanguage(QAction *))); 

QDir dir(qmPath) ; 
QStringList fileNames = 

dir .entryList (QStringList ( "callcenterj* .qm" ) ) ; 

for (int i = 0; i < fileNames. size() ; ++i) { 
QString locale = fileNames[i] ; 
locale. remove(0, locale. indexOf ( '_' ) +1); 
locale. truncate(locale.lastIndexOf( '.')); 

QTranslator translator; 
translator. load (fileNames [i] , qmPath) ; 
QString language = translator. translate ("MainWindow" , 

"English" ) ; 
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QAction *action = new QAction(tr( %2") 

.arg(i + 1 ) .arg(language) , this); 

action->setCheckable(true) ; 
action->setData(locale) ; 

languageMenu->addAction( action) ; 
languageActionGroup->addAction( action) ; 

if (language == "English") 
action->setChecked(true) ; 

} 

} 

Au lieu de coder en dur les langues prises en charge par l'application, nous creons une entree 
de menu pour chaque fichier . qm situe dans le repertoire translations de l'application. Pour des 
raisons de simplicite, nous supposons que la langue anglaise (English) possede aussi un fichier 
.qm. Une alternative consisterait a appeler clear () sur les objets QTranslator lorsque 
l'utilisateur choisit English. 

La difficulte consiste a trouver un nom adequat pour la langue fournie par chaque fichier . qm. 
Le fait d'afficher simplement "en" pour "English" ou "de" pour "Deutsch" semble primaire et 
risque de semer la confusion dans 1' esprit de certains utilisateurs. La solution retenue dans 
createLanguageMenu ( ) est de controler la traduction de la chaine "English" dans le contexte 
"Main Window". Cette chaine doit etre transformee en "Deutsch" pour une traduction alle- 

mande et en " H^li" pour une traduction japonaise. 

Nous creons un QAction a cocher pour chaque langue et stockons le nom local dans 1' element 
"data" de Taction. Nous les ajoutons a un objet QActionGroup afin de nous assurer qu'un seul 
element du menu Language est coche a la fois. Quand une action du groupe est choisie par 
l'utilisateur, le QActionGroup emet le signal triggered (QAction *), qui est connecte a 
switchLanguage ( ). 

void MainWindow: : switchLanguage(QAction *action) 
{ 

QString locale = action->data( ) .toString( ) ; 
appTranslator.load( "callcenter_" + locale, qmPath); 
qtTranslator.load( "qt_" + locale, qmPath); 
retranslateUi( ) ; 

} 

Le slot switchLanguage ( ) est appele lorsque l'utilisateur choisit une langue dans le menu 
Language. Nous chargeons les fichiers de traduction de l'application et de Qt, et nous appelons 
retranslateUi ( ) pour traduire toutes les chaines de la fenetre principale. 

Sur Windows, une solution alternative au menu Language consisterait a repondre a des evene- 
ments LocaleChange, un type d'evenement emis par Qt quand un changement dans les para- 
metres locaux de l'environnement est detecte. Ce type existe sur toutes les plates-formes prises 
en charge par Qt, mais il n'est en fait genere que sur Windows, lorsque l'utilisateur change les 
parametres locaux du systeme (dans les Options regionales et linguistiques du Panneau de 
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configuration). Pour gerer les evenements LocaleChange, nous pouvons reimplementer 
QWidget : : changeEvent ( ) comme suit : 

void MainWindow: : changeEvent (QEvent *event) 
{ 

if (event->type() == QEvent :: LocaleChange) { 
appTranslator.loadf "callcenter_" 

+ QLocale: :system() .name() , qmPath); 
qtTranslator.load( "qt_" + QLocale: :system() .name() , qmPath); 
retranslateUi( ) ; 

} 

QMainWindow: :changeEvent(event) ; 

} 

Si l'utilisateur change les parametres locaux pendant que l'application est en cours d'execution, 
nous tentons de charger les fichiers de traduction corrects pour les nouveaux parametres et 
appelons retranslateUi ( ) pour mettre a jour l'interface utilisateur. Dans tous les cas, nous 
transmettons l'evenement a la fonction changeEvent ( ) de la classe de base, cette derniere 
pouvant aussi etre interessee par LocaleChange ou d'autres evenements de changement. 

Nous en avons maintenant termine avec l'examen du code de MainWindow. Nous allons a 
present observer le code de l'une des classes de widget de l'application, la classe Journal- 
View, arm de determiner quelles modifications sont necessaires pour lui permettre de prendre 
en charge la traduction dynamique. 

JournalView: :JournalView(QWidget *parent) 
: QTableWidget( parent) 

{ 

retranslateUi( ) ; 

} 

La classe JournalView est une sous-classe de QTableWidget. A la fin du constructeur, nous 
appelons la fonction privee retranslateUi ( ) pour definir les chaines des widgets. Cette 
operation est similaire a celle que nous avons effectuee pour MainWindows. 

void JournalView: :changeEvent(QEvent *event) 
{ 

if (event->type() == QEvent :: LanguageChange) 

retranslateUif ) ; 
QTableWidget: :changeEvent(event) ; 

} 

Nous reimplementons egalement la fonction changeEvent() pour appeler retransla- 
teUi() sur les evenements LanguageChange. Qt genere un evenement LanguageChange 
lorsque le contenu d'un QTranslator installe sur QApplication change. Dans notre applica- 
tion, ceci se produit lorsque nous appelons load() sur appTranslator ou qtTranslator 
depuis MainWindow: : switchLanguage ( ) ou MainWindow: : changeEvent ( ). 
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Les evenements LanguageChange ne doiventpas etre confondus avec les evenements Locale- 
Change. Ces derniers sont generes par le systeme et demandent a l'application de charger une 
nouvelle traduction. Les evenements LanguageChange sont generes par Qt et demandent aux 
widgets de l'application de traduire toutes leurs chaines. 

Lorsque nous avons implements MainWindow, il ne nous a pas ete necessaire de repondre a 
LanguageChange. Nous avons simplement appele retranslateUi( ) a chaque appel de 
load() sur un QTranslator. 

void JournalView: : retranslateUi( ) 
{ 

QStringList labels; 

labels « tr("Tlme") « tr( "Priority" ) « tr( "Phone Number") 

« tr( "Subject" ) ; 
setHorizontalHeaderLabelsf labels) ; 

} 

La fonction retranslateUi ( ) met a jour les en-tetes de colonnes avec les textes nouvel- 
lement traduits, completant ainsi la partie traduction du code d'un widget ecrit a la main. Pour 
ce qui est des widgets et des boites de dialogue developpes avec Qt Designer, l'outil uic 
genere automatiquement une fonction similaire a retranslateUi( ). Celle-ci est automati- 
quement appelee en reponse aux evenements LanguageChange. 

Traduire les applications 

La traduction d'une application Qt qui contient des appels a t r ( ) est un processus en trois etapes : 

1. Execution de lupdate pour extraire toutes les chaines visibles par l'utilisateur du code 
source de l'application. 

2. Traduction de l'application au moyen de Qt Linguist. 

3. Execution de lrelease pour generer des fichiers binaires . qm que l'application peut charger 
au moyen de QTranslator. 

La responsabilite des etapes 1 et 3 revient aux developpeurs. Letape 2 est geree par les traducteurs. 
Ce cycle peut etre repete aussi souvent que necessaire pendant le developpement et la duree de 
vie de l'application. 

Nous allons, par exemple, vous montrer comment traduire l'application Spreadsheet du Chapitre 3. 
Cette application contient deja des appels de tr ( ) encadrant chaque chaine visible par l'utilisateur. 

Dans un premier temps, nous devons modifier le fichier .pro de l'application pour preciser 
quelles langues nous souhaitons prendre en charge. Si, par exemple, nous voulons prendre en 
charge l'allemand et le francais en plus de 1' anglais, nous ajoutons l'entree TRANSLATIONS 
suivante a spreadsheet . pro : 

TRANSLATIONS = spreadsheet_de . ts \ 
spreadsheet_f r.ts 
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Ici, nous mentionnons deux fichiers de traduction : un pour l'allemand et un pour le francais. 
Ces fichiers seront crees lors de la premiere execution de lupdate et seront charges a chacune 
de ses executions ulterieures. 

Ces fichiers possedent normalement une extension . ts. lis se trouvent dans un format XML 
simple et ne sont pas aussi compacts que les fichiers binaires . qm compris par QTranslator. 
La tache de conversion des fichiers . ts lisibles par l'homme en fichiers . qm efficaces pour la 
machine revient a lrelease. Pour les esprits curieux, . ts et . qm signifient fichier "translation 
source" et fichier "Qt message", respectivement. 

En supposant que nous nous trouvions dans le repertoire contenant le code source de 1' applica- 
tion Spreadsheet, nous pouvons executer lupdate sur spreadsheet a partir de la ligne de 
commande comme suit : 

lupdate -verbose spreadsheet. pro 

Loption -verbose invite lupdate a fournir plus de commentaires que d'habitude. Voici la 
sortie attendue : 

Updating 1 spreadsheet_de.ts ' . . . 

Found 98 source texts (98 new and 0 already existing) 

Updating 1 spreadsheet_f r.ts ' . . . 

Found 98 source texts (98 new and 0 already existing) 

Chaque chaine qui apparait dans un appel de tr( ) dans le code source de 1' application est 
stockee dans les fichiers .ts, avec une traduction vide. Les chaines qui apparaissent dans les 
fichiers . ui de 1' application sont egalement incluses. 

Loutil lupdate suppose par defaut que les arguments de tr ( ) sont des chaines Latin-1. Si tel 
n'est pas le cas, nous devons ajouter une entree CODECFORTR au fichier . pro. Par exemple : 

CODECFORTR = EUC-JP 

Cette operation doit etre realisee en plus de l'appel a QTextCodec: : setCodecForTr( ) 
depuis la fonction main ( ) de 1' application. 

Les traductions sont alors ajoutees aux fichiers spreadsheet_de . ts et spreadsheet_f r . ts 
au moyen de Qt Linguist. 

Pour executer Qt Linguist, cliquez sur Qt by Trolltech v4.x.y/Linguist dans le menu Demarrer 
sous Windows, saisissez linguist sur la ligne de commande sous Unix ou double-cliquez sur 
Linguist dans le Finder de Mac OS X. Pour commencer a ajouter des traductions a un fichier 
. ts, cliquez sur File/Open et selectionnez le fichier a traduire. 

La partie gauche de la fenetre principale de Qt Linguist affiche la liste des contextes pour 
l'application en cours de traduction. En ce qui concerne l'application Spreadsheet, les contex- 
tes sont "FindDialog", "GoToCellDialog", "Main Windows", "SortDialog" et "Spreadsheet". La 
zone superieure droite est la liste des textes sources pour le contexte en cours. Chaque texte 
source est presente avec une traduction et un indicateur Done. La zone du milieu nous permet 
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d'entrer une traduction pour l'element source active. Dans la zone inferieure droite apparait 
une liste de suggestions fournies automatiquement par Qt Linguist. 

Lorsque nous disposons d'un fichier .ts traduit, nous devons le convertir en un fichier 
binaire . qm arin qu'il puisse etre exploite par QTranslator. Pour effectuer cette operation 
depuis Qt Linguist, cliquez sur File /Release. Nous commencons generalement par 
traduire quelques chaines et nous executons 1' application avec le fichier .qm pour nous assurer 
que tout fonctionne correctement. (Voir Figure 17.2) 
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Si vous souhaitez generer les fichiers .qm pour tous les fichiers .ts, vous pouvez utiliser 
l'outil lrelease comme suit : 



lrelease -verbose spreadsheet. pro 



En supposant que vous avez traduit dix-neuf chaines en francais et clique sur l'indicateur Done 
pour dix-sept d'entre elles, lrelease produit la sortie suivante : 

Updating 'spreadsheet_de.qm' . . . 

Generated 0 translations (0 finished and 0 unfinished) 

Ignored 98 untranslated source texts 
Updating 'spreadsheet_fr.qm' . . . 

Generated 19 translations (17 finished and 2 unfinished) 

Ignored 79 untranslated source texts 

Les chaines non traduites sont presentees dans les langues initiales lors de l'execution de 
1' application. L'indicateur Done est ignore par lrelease. II peut etre utilise par les traducteurs 
pour identifier les traductions terminees et celles qui ont encore besoin d'etre revisees. 
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Lorsque nous modifions le code source de 1' application, les fichiers de traduction deviennent 
obsoletes. La solution consiste a executer de nouveau lupdate, a fournir les traductions pour 
les nouvelles chaines et a regenerer les fichiers .qm. Certaines equipes de developpement 
considerent qu'il faut regulierement executer lupdate, alors que d'autres preferent attendre 
que 1' application soit prete a etre commercialisee. 

Les outils lupdate et Qt Linguist sont relativement intelligents. Les traductions qui ne sont 
plus utilisees sont conservees dans les fichiers . ts au cas ou elles seraient necessaires dans des 
versions ulterieures. Lors de la mise a jour des fichiers . ts, lupdate utilise un algorithme de 
fusion intelligent qui permet aux traducteurs d'economiser un temps considerable dans le cas 
de texte identique ou similaire utilise dans des contextes differents. 

Pour plus d' informations concernant Qt Linguist, lupdate et lrelease, referez-vous au 
manuel Qt Linguist a l'adresse http://doc.trolltech.eom/4.l/linguist-manual.html. Ce 

manuel contient une etude detaillee de l'interface utilisateur de Qt Linguist et un didactitiel 
pour les programme urs. 
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Environnement multithread 



Les applications GUI conventionnelles possedent un thread d' execution et realisent, en regie 
generale, une seule operation a la fois. Si l'utilisateur invoque une operation longue depuis 
1' interface utilisateur, cette derniere se fige pendant la progression de 1' operation. Le Chapi- 
tre 7 presente des solutions a ce probleme. L' environnement multithread en est une autre. 

Dans une application multithread, l'interface utilisateur graphique s'execute dans son 
propre thread et le traitement a lieu dans un ou plusieurs threads distincts. De cette 
facon, l'interface utilisateur graphique des applications reste reactive, meme pendant un 
traitement intensif. Un autre avantage de 1' environnement multitread est le suivant : les 
systemes multiprocesseurs peuvent executer plusieurs threads simultanement sur differents 
processeurs, offrant ainsi de meilleures performances. 

Dans ce chapitre, nous allons commencer par vous montrer comment deriver QThread et 
comment utiliser QMutex, QSemaphore ainsi que QWaitCondition pour synchroniser 
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les threads. Puis nous vous expliquerons comment communiquer avec le thread principal 
depuis les threads secondaires pendant que la boucle d'evenement est en cours d'execution. 
Nous conclurons enfin par une etude des classes Qt susceptibles ou non d'etre utilisees dans 
des threads secondaires. 

Lenvironnement multithread est un sujet vaste, auquel de nombreux livres sont exclusivement 
consacres. Ici, nous supposons que vous maitrisez les bases de la programmation multithread. 
Nous insisterons davantage sur la facon de developper des applications Qt multithread plutot 
que sur le theme du decoupage en threads lui-meme. 

Creer des threads 

II n'est pas difficile de fournir plusieurs threads dans une application Qt : il suffit de deriver 
QThread et de reimplementer sa fonction run(). Pour illustrer cette operation, nous allons 
commencer par examiner le code d'une sous-classe QThread tres simple qui affiche de facon 
repetee une chaine donnee sur une console. 

class Thread : public QThread 
{ 

Q_0BJECT 
public: 
Thread () ; 

void setMessagefconst QString &message); 
void stop( ) ; 

protected: 
void run(); 

private: 

QString messageStr; 
volatile bool stopped; 

}; 

La classe Thread herite de QThread et reimplemente la fonction run(). Elle fournit deux 
fonctions supplementaires : setMessage ( ) et stop ( ) . 

La variable stopped est declaree volatile car il est possible d'y acceder depuis plusieurs 
threads et nous souhaitons garantir une lecture de sa version actualisee a chaque fois qu'elle est 
necessaire. Si nous omettons le mot-cle volatile, le compilateur peut optimiser l'acces a la 
variable, ce qui risque d'aboutir a des resultats incorrects. 

Thread: :Thread() 
{ 

stopped = false; 

} 



Nous avons defini stopped en false dans le constructeur. 
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void Thread: :run() 
{ 

while (! stopped) 

cerr « qPrintable(messageStr) ; 
stopped = false; 
cerr « endl; 

} 

La fonction run ( ) est appelee pour lancer l'execution du thread. Tant que la variable stopped 
est definie en false, la fonction continue a afficher le message donne sur la console. Le thread 
se termine lorsque la fonction run ( ) rend le controle. 

void Thread: :stop( ) 
{ 

stopped = true; 

} 

La fonction stop( ) definit la variable stopped en true, indiquant ainsi a run( ) d'interrom- 
pre l'affichage du texte sur la console. Cette fonction peut etre appelee a tout moment depuis 
un thread quelconque. Dans le cadre de cet exemple, nous supposons que 1' affectation a un 
bool est une operation atomique. C'est une supposition raisonnable, si Ton considere qu'un bool 
ne peut avoir que deux etats. Nous verrons ulterieurement comment utiliser QMutex pour 
garantir l'atomicite de 1' affectation a une variable. 

QThread fournit une fonction terminate () qui met fin a l'execution d'un thread pendant 
qu'il est toujours en cours d'execution. Lemploi de terminate ( ) n'est pas conseille, car elle 
peut mettre fin au thread a tout moment et ne donne a ce dernier aucune chance de lancer les 
operations de recuperation de la memoire. II est toujours preferable de faire appel a une variable 
stopped et a une fonction stop ( ) comme c'est le cas ici. 

Figure 18.1 

L' application Threads 
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A present, nous allons voir comment utiliser la classe Thread dans une petite application Qt 
qui utilise deux threads, A et B, en plus du thread principal. 

class ThreadDialog : public QDialog 
{ 

Q_0BJECT 
public: 

ThreadDialog(QWidget *parent = 0); 

protected: 

void closeEvent(QCloseEvent *event); 

private slots: 

void startOrStopThreadA( ) ; 
void startOrStopThreadB( ) ; 
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private: 

Thread threadA; 
Thread threadB; 
QPushButton *threadAButton; 
QPushButton *threadBButton; 
QPushButton *quitButton; 

}; 

La classe ThreadDialog declare deux variables de type Thread et quelques boutons pour 
fournir une interface utilisateur de base. 

ThreadDialog: :ThreadDialog(QWidget *parent) 
: QDialog(parent) 

{ 

threadA. setMessage( "A" ) ; 
threadB. setMessage( "B" ) ; 

threadAButton = new QPushButton(tr( "Start A")); 
threadBButton = new QPushButton(tr( "Start B")); 
quitButton = new QPushButton(tr( "Quit" ) ) ; 
quitButton->setDefault(true) ; 

connect (threadAButton , SIGNAL(clicked () ) , 
this, SLOT(startOrStopThreadA( ) ) ) ; 

connect (threadBButton , SIGNAL(clicked ( ) ) , 
this , SLOT ( startOrStopThreadB ( ) ) ) ; 

} 

Dans le constructeur, nous appelons setMessage() pour amener le premier et le second thread a 
afficher de facon repetee des 'A' et des 'B', respectivement. 

void ThreadDialog: :startOrStopThreadA() 
{ 

if (threadA. isRunning()) { 
threadA. stop( ) ; 

threadAButton->setText(tr( "Start A" ) ) ; 
} else { 

threadA. start () ; 

threadAButton->setText(tr( "Stop A" ) ) ; 

} 

} 

Lorsque Putilisateur clique sur le bouton correspondant au thread A, startOrStopThreadA( ) 
stoppe ce dernier s'il etait en cours d' execution ou le lance dans le cas contraire. Elle met 
egalement a jour le texte du bouton. 

void ThreadDialog: :startOrStopThreadB() 
{ 

if (threadB. isRunning()) { 
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threadB.stop() ; 

threadBButton->setText(tr( "Start B " ) ) ; 
} else { 

threadB. start () ; 

threadBButton->setText(tr( "Stop B " ) ) ; 

} 

} 

Le code de startOrStopThreadB( ) est tres similaire. 

void ThreadDialog: :closeEvent(QCloseEvent *event) 
{ 

threadA. stop( ) ; 
threadB. stop( ) ; 
threadA. wait() ; 
threadB. wait() ; 
event->accept( ) ; 

} 

Si l'utilisateur clique sur Quit ou ferme la fenetre, nous arretons tous les threads en cours 
d'execution et attendons leur fin (en executant QThread : : wait ( )) avant d'appeler QClose- 
Event : : accept ( ) . Ce processus assure une fermeture correcte de 1' application, bien qu'il ne 
presente pas vraiment d'importance dans le cadre de cet exemple. 

Si vous executez l'application et cliquez sur Start A, la console se remplit de 'A'. Si vous 
cliquez sur Start B, elle se remplit maintenant de sequences alternatives de 'A' et de 'B'. Cliquez 
sur Stop A, et elle n'affiche alors que les 'B'. 

Synchroniser des threads 

La synchronisation de plusieurs threads represente une necessite pour la plupart des applications 
multithread. Qt fournit les classes de synchronisation suivantes : QMutex, QReadWriteLock, 
QSemaphore et QWaitCondition. 

La classe QMutex offre un moyen de proteger une variable ou une partie de code de sorte qu'un 
seul thread puisse y acceder a la fois. Elle fournit une fonction lock ( ) qui verrouille le mutex. 
Si ce dernier est deverrouille, le thread en cours s'en empare immediatement et le verrouille. 
Dans le cas contraire, le thread en cours est bloque jusqu'a ce que celui qui le contient le dever- 
rouille. Dans tous les cas, lorsque l'appel a lock ( ) se termine, le thread en cours conserve le 
mutex jusqu'a ce que unlock ( ) soit appele. La classe QMutex fournit egalement une fonction 
tryLock ( ) qui se termine immediatement si le mutex est deja verrouille. 

Supposons, par exemple que nous souhaitions proteger la variable stopped de la classe 
Thread de la section precedente avec un QMutex. Nous ajouterions alors la donnee membre 
suivante a Thread : 



private: 
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QMutex mutex; 

}; 

La fonction run ( ) prendrait la forme suivante : 

void Thread: :run() 
{ 

forever { 

mutex. lock ( ) ; 
if (stopped) { 

stopped = false; 

mutex. unlock() ; 

break; 

} 

mutex. unlockf) ; 

cerr « qPrintable(messageStr) ; 

} 

cerr « endl; 

} 

La fonction stop ( ) prendrait la forme suivante : 

void Thread: :stop( ) 
{ 

mutex. lock() ; 
stopped = true; 
mutex. unlock() ; 

} 

Les operations de verrouillage et de deverrouillage d'un mutex dans les fonctions complexes, 
ou celles utilisant des exceptions C++, peuvent etre sujettes a erreur. Qt offre la classe utilitaire 
QMutexLocker pour simplifier la gestion des mutex. Le constructeur de QMutexLocker 
accepte QMutex comme argument et le verrouille. Le destructeur de QMutexLocker dever- 
rouille le mutex. Nous pourrions, par exemple, reecrire les fonctions run ( ) et stop ( ) comme 
suit : 

void Thread: :run() 
{ 

forever { 
{ 

QMutexLocker lockerf&mutex) ; 
if (stopped) { 

stopped = false; 

break; 

} 

} 

cerr « qPrintable(messageStr) ; 

} 

cerr « endl; 

} 
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void Thread: :stop( ) 
{ 

QMutexLocker locker(&mutex) ; 
stopped = true; 

} 

Le probleme de l'emploi des mutex est que seul un thread peut acceder a la meme variable a la 
fois. Dans les programmes avec de nombreux threads essayant de lire la meme variable simul- 
tanement (sans la modifier), le mutex risque de compromettre serieusement les performances. 
Dans ces situations, nous pouvons faire appel a QReadWriteLock, une classe de synchronisation 
qui autorise des acces simultanes en lecture seulement sans alterer les performances. 

Dans la classe Thread, il serait illogique de remplacer QMutex par QReadWriteLock pour prote- 
ger la variable stopped, car un thread au maximum tentera de lire la variable a un moment donne. 
Un exemple plus approprie impliquerait un ou plusieurs threads de lecture accedant a des 
donnees partagees et un ou plusieurs threads d'ecriture modifiant les donnees. Par exemple : 

MyData data; 
QReadWriteLock lock; 

void ReaderThread: :run() 
{ 

lock.lockForRead() ; 

access_data_without_modifying_it (Sdata) ; 
lock.unlock() ; 

} 

void WriterThread: :run() 
{ 

lock.lockForWrite() ; 
modify_data(&data) ; 
lock.unlock() ; 

} 

Pour des raisons de commodite, il est possible d'utiliser les classes QReadLocker et QWrite- 
Locker pour verrouiller et deverrouiller un QReadWriteLock. 

QSemaphore est une autre generalisation des mutex, mais contrairement au verrouillage en 
lecture/ecriture, les semaphores peuvent etre employes pour proteger un certain nombre de 
ressources identiques. Les deux extraits de code suivants montrent la correspondance entre 
QSemaphore et QMutex : 



QSemaphore semaphore (1 ) ; QMutex mutex; 
semaphore. acquire ( ) ; mutex. lock ( ) ; 
semaphore . release ( ) ; mutex . unlock( ) ; 
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En transmettant 1 au constructeur, nous indiquons au semaphore qu'il ne controle qu'une seule 
ressource. L'avantage de l'emploi d'un semaphore est que nous pouvons transmettre un 
nombre superieur a 1 au constructeur, puis appeler acquire ( ) a plusieurs reprise pour acquerir 
de nombreuses ressources. 

Une application typique des semaphores est le transfert d'une certaine quantite de donnees 
(DataSize) entre deux threads a l'aide d'une memoire tampon circulaire partage d'une 
certaine taille (Buf f erSize) : 

const int DataSize = 100000; 
const int BufferSize = 4096; 
char buff er[BufferSize] ; 

Le thread producteur ecrit les donnees dans la memoire tampon jusqu' a ce qu'il atteigne la fin, 
puis recommence au debut, ecrasant les donnees existantes. Le thread consommateur lit les 
donnees lors de sa generation. La Figure 18.2 illustre ce processus, avec une memoire tampon 
minuscule de 16 octets. 



Figure 18.2 
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Le besoin de synchronisation dans l'exemple producteur/consommateur est double : si le 
producteur genere les donnees trop rapidement, il ecrasera celles que le consommateur n'aura 
pas encore lues et si le consommateur lit trop rapidement, il depassera le producteur et obtiendra 
des donnees incoherentes. 

Un moyen radical de resoudre ce probleme consiste a amener le producteur a remplir la 
memoire tampon, puis a attendre que le consommateur ait lu cette derniere en entier, et ainsi de 
suite. Mais sur les machines multiprocesseurs, ce processus n'est pas aussi rapide que celui 
consistant a laisser les threads producteur et consommateur agir sur differentes parties de la 
memoire tampon en me me temps. 

Pour resoudre efficacement ce probleme, il est possible de recourir a deux semaphores : 

QSemaphore f reeSpace(Buff erSize) ; 
QSemaphore usedSpace(0) ; 

Le semaphore f reeSpace gouverne la partie de la memoire tampon que le producteur remplit 
de donnees. Le semaphore usedSpace gouverne la zone susceptible d'etre lue par le consom- 
mateur. Ces deux regions sont complementaires. Le semaphore f reeSpace est initialise avec 
BufferSize (4096), ce qui signirie qu'il possede autant de ressources qu'il est possible d'en 
acquerir. Lorsque 1' application demarre, le thread lecteur commence par acquerir des octets 
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"libres" et les convertit en octets "utilises". Le semaphore usedSpace est initialise avec la 
valeur 0 pour s' assurer que le consommateur ne lit pas des donnees incoherentes au demarrage. 

Dans cet exemple, chaque octet est considere comme une ressource. Dans une application du 
monde reel, nous agirions probablement sur des unites de taille plus importante (64 ou 256 octets 
a la fois, par exemple) pour reduire la surcharge associee a l'emploi des semaphores. 

void Producer: :run() 
{ 

for (int i = 0; i < DataSize; ++i) { 
freeSpace. acquire ( ) ; 

buffer[i % BufferSize] = "ACGT" [uint (rand ( ) ) % 4]; 
usedSpace. release ( ) ; 

} 

Dans le producteur, chaque iteration debute par 1' acquisition d'un octet "libre".Si la memoire 
tampon est remplie de donnees n' ay ant pas encore ete lues par le consommateur, l'appel a 
acquire ( ) bloquera le processus jusqu'a ce que le consommateur ait commence a consom- 
mer les donnees. Une fois l'octet acquis, nous le remplissons de donnees aleatoires ('A', 'C, 
'G' ou 'T') et le liberons avec le statut "utilise", de sorte qu'il puisse etre lu par le thread 
consommateur. 

void Consumer: :run() 
{ 

for (int i = 0; i < DataSize; ++i) { 
usedSpace. acquiref ) ; 
cerr « buffer[i % BufferSize]; 
freeSpace. releasef ) ; 

} 

cerr « endl; 

} 

Dans le consommateur, nous commencons par acquerir un octet "utilise". Si la memoire 
tampon ne contient aucune donnee a lire, l'appel a acquire ( ) bloquera le processus jusqu'a 
ce que le producteur en ait produites. Une fois l'octet acquis, nous l'affichons et le liberons 
avec le statut "libre", en permettant ainsi au producteur de le remplir de nouveau avec des 
donnees. 

int main() 
{ 

Producer producer; 
Consumer consumer; 
producer. start( ) ; 
consumer. start() ; 
producer. wait( ) ; 
consumer. wait( ) ; 
return 0; 

} 



416 Qt4etC++ : Programmation d'interfaces GUI 



Enfin, nous lancons les threads producteur et consommateur dans main(). Le producteur 
convertit alors de l'espace "libre" en espace "utilise", puis le consommateur le reconvertit en 
espace "libre". 

Lorsque nous executons le programme, il ecrit une sequence aleatoire de 100 000 'A', 'C, 'G' 
et 'T' sur la console et se termine. Pour vraiment comprendre ce qui se passe, nous pouvons 
desactiver l'ecriture de la sortie et ecrire a la place un 'P' a chaque fois que le producteur 
genere un octet et 'c' a chaque fois que le consommateur en lit un. Pour simplifier les choses, 
nous pouvons utiliser des valeurs plus petites pour DataSize et Buf f erSize. 

Voici, par exemple, une execution possible avec un DataSize de 1 0 et un Buf f erSize de 4 : 
"PcPcPcPcPcPcPcPcPcPc". Dans ce cas, le consommateur lit les octets des qu'ils sont generes 
par le producteur. Les deux threads sont executes a la meme vitesse. II est egalement possible 
que le producteur remplisse toute la memoire tampon avant que le consommateur ne 
commence sa lecture : "PPPPccccPPPPccccPPcc". II existe de nombreuses autres possibilites. 
Les semaphores offrent une grande liberte au planificateur de thread specifique au systeme, qui 
peut etudier le comportement des threads et choisir une strategie de planification appropriee. 

Une approche differente au probleme de synchronisation d'un producteur et d'un consomma- 
teur consiste a employer QWaitCondition et QMutex. Un QWaitCondition permet a un 
thread d'en reveiller d' autres lorsque les conditions requises sont remplies. Cette approche 
autorise un controle plus precis qu'avec les mutex seuls. Pour illustrer le fonctionnement de ce 
processus, nous allons reprendre 1' exemple producteur/consommateur en declarant des conditions 
d'attente. 

const int DataSize = 100000; 
const int BufferSize = 4096; 
char buff er[BufferSize] ; 

QWaitCondition bufferlsNotFull; 
QWaitCondition bufferlsNotEmpty; 
QMutex mutex; 
int usedSpace = 0; 

En plus du tampon, nous declarons deux QWaitConditions, un QMutex et une variable qui 
stocke le nombre d'octets "utilises" dans la memoire tampon. 

void Producer: :run() 
{ 

for (int i = 0; i < DataSize; ++i) { 
mutex. lock () ; 

while (usedSpace == BufferSize) 
bufferlsNotFull. wait(&mutex) ; 
buffer[i % BufferSize] = "ACGT" [uint (rand ( ) ) % 4]; 
++usedSpace; 

buff erlsNotEmpty .wakeAll( ) ; 
mutex. unlockf) ; 

} 

} 
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Dans le producteur, nous commencons par verifier si la memoire tampon est remplie. Si tel est 
le cas, nous attendons la condition "buffer is not full".Une fois cette condition remplie, nous 
ecrivons un octet dans la memoire tampon, nous incrementons usedSpace, puis nous reveillons 
tout thread en attente de la condition "buffer is not full". 

Nous faisons appel a un mutex pour proteger tous les acces a la variable usedSpace. La fonction 
QWaitCondition : : wait ( ) peut recevoir un mutex verrouille comme premier argument, qu'elle 
deverrouille avant de bloquer le thread en cours puis verrouille avant de rendre le controle. 

Dans cet exemple, nous aurions pu remplacer la boucle while 

while (usedSpace == BufferSize) 
bufferlsNotFull.waitf&mutex) ; 

par cette instruction if : 

if (usedSpace == BufferSize) { 
mutex. unlock() ; 
bufferIsNotFull.wait() ; 
mutex. lock() ; 

} 

Ce processus risque d'etre perturbe si nous autorisons plusieurs threads producteurs, car un 
autre producteur pourrait se saisir du mutex immediatement apres 1' appel de wait ( ) et annuler 
la condition "buffer is not full". 

void Consumer: :run() 
{ 

for (int i = 0; i < DataSize; ++i) { 
mutex. lock () ; 
while (usedSpace == 0) 

buff erlsNotEmpty .wait(Smutex) ; 
cerr « buffer[i % BufferSize]; 
--usedSpace; 

bufferIsNotFull.wakeAll() ; 
mutex. unlockf) ; 

} 

cerr « endl; 

} 

L' action du consommateur est tres exactement opposee a celle du producteur : il attend la 
condition "buffer is not full" et reveille tout thread en attente de la verification de cette condition. 

Dans tous les exemples etudies jusqu'a present, nos threads ont accede aux memes variables 
globales. Mais dans certaines applications, une variable globale doit contenir differentes 
valeurs dans differents threads. Ce precede se nomme souvent stockage local de thread ou 
donnee specifique aux threads. Nous pouvons le reproduire en utilisant un map indexe sur les 
ID de thread (retournes par QThread : : currentThread ( )), mais une approche plus elegante 
consiste a faire appel a la classe QThreadStorage<T>. 
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Cette classe est generalement utilisee pour les caches. En ayant un cache distinct dans les diffe- 
rents threads, nous evitons la surcharge du verrouillage, deverrouillage et d'attente d'un mutex. 
Par exemple : 

QThreadStorage<QHash<int, double> *> cache; 

void insertIntoCache(int id, double value) 
{ 

if ( !cache.hasLocalData( ) ) 

cache. setLocalData(new QHash<int, double>); 
cache. localDataf ) ->insert( id, value) ; 

} 

void removeFromCache(int id) 
{ 

if (cache. hasLocalData()) 

cache. localDataf ) ->remove(id) ; 

} 

La variable cache contient un pointeur vers un QMap<int , double> par thread. Lorsque nous 
utilisons le cache pour la premiere fois dans un thread particulier, hasLocalData( ) retourne 
false et nous creons l'objet QHash<int , double>. 

QThreadStorage<T> peut egalement etre utilise pour les variables d'etat d'erreur globales 
(exactement comme errno) afin de s'assurer que les modifications apportees a un thread 
n'affectent pas les autres. 



Communiquer avec le thread principal 

Quand une application Qt demarre, un seul thread s'execute - le thread principal. C'est le seul 
thread qui est autorise a creer l'objet QApplication ou QCoreApplication et a appeler 
exec ( ) sur celui-ci. Apres l'appel a exec ( ) , ce thread est soit en attente d'un evenement, soit 
en cours de traitement d'un evenement. 

Le thread principal peut demarrer de nouveaux threads en creant les objets d'une sous-classe 
QThread, comme ce fut le cas dans la section precedente. Si ces nouveaux threads doivent 
communiquer entre eux, ils peuvent utiliser des variables partagees avec des mutex, des 
verrouillages en lecture/ecriture, des semaphores ou des conditions d'attente. Mais aucune 
de ces techniques ne peut etre exploitee pour communiquer avec le thread principal, car elles 
verrouilleraient la boucle de l' evenement et figeraient l' interface utilisateur. 

La solution pour communiquer avec le thread principal depuis un thread secondaire consiste a 
faire appel a des connexions signal/slot entre threads. En regie generale, le mecanisme des 
signaux et des slots opere de facon synchrone. Les slots sont done connectes a un signal et 
invoques immediatement une fois le signal emis, par le biais d'un appel de fonction direct. 
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Cependant, lorsque nous connectons des objets "actifs" dans des threads differents, le mecanisme 
devient asynchrone. (Ce comportement peut etre modifie par le biais d'un cinquieme parame- 
tre facultatif de QObj ect : : connect ( ).) Ces connexions sont implementees a l'arriere-plan en 
publiant un evenement. Le slot est alors appele par la boucle d'evenement du thread dans 
laquelle se trouve l'objet destinataire. Par defaut, un QObj ect se situe dans le thread ou il a ete 
cree. Ceci peut etre change a tout moment en appelant QObj ect : : moveToThread ( ). 



Figure 18.3 

L' application Image Pro 
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Pour illustrer le fonctionnement des connexions signal/slot entre threads, nous allons etudier le 
code de 1' application Image Pro, une application de retouche d'images de base qui permet a 
l'utilisateur de faire pivoter, de redimensionner et de changer la precision des couleurs d'une 
image. L' application utilise un thread secondaire pour pouvoir realiser des operations sur les images 
sans verrouiller la boucle d'evenement. La difference est significative lors du traitement de tres 
grosses images. Le thread secondaire possede une liste de taches, ou "transactions", a accomplir 
et envoie les evenements a la fenetre principale pour indiquer la progression. 

ImageWindow: : ImageWindow( ) 
{ 

imageLabel = new QLabel; 

imageLabel->setBackgroundRole(QPalette: :Dark) ; 
imageLabel->setAutoFillBackground(true) ; 
imageLabel->setAlignment(Qt : :AlignLeft | Qt: :AlignTop) ; 
setCentralWidget(imageLabel) ; 

createActions( ) ; 
createMenus() ; 

statusBar( ) ->showMessage(tr( "Ready" ) , 2000) ; 

connect (&thread, SIGNAL(transactionStarted (const QString &)), 

statusBar(), SLOT(showMessage(const QString &))); 
connect (&thread, SIGNAL(finishedf) ) , 
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this, SLOT(allTransactionsDone( ) ) ) ; 
setCurrentFile( " " ) ; 

} 

La partie la plus interessante du constracteur de ImageWindow contient les deux connexions 
signal/slot. Toutes deux impliquent des signaux emis par l'objet TransactionThread, sur 
lequel nous reviendrons dans un instant. 

void ImageWindow: :f lipHorizontally ( ) 
{ 

addTransaction(new FlipTransaction(Qt: :Horizontal) ) ; 

} 

Le slot f lipHorizontally ( ) cree une transaction "de rotation" et l'enregistre au moyen de la 
fonction privee addTransaction ( ). Les fonctions f lipVertically ( ), resizelmage ( ), 
convertTo32Bit ( ), convertTo8Bit ( ) et convertTol Bit ( ) sont similaires. 

void ImageWindow: :addTransaction(Transaction *transact) 
{ 

thread .addTransaction (transact) ; 
openAction->setEnabled(false) ; 
saveAction->setEnabled (false) ; 
saveAsAction->setEnabled (false) ; 

} 

La fonction addTransaction ( ) ajoute une transaction a la file d'attente de transactions du 
thread secondaire et desactive les actions Open, Save et Save As pendant que les transactions 
sont en cours de traitement. 

void ImageWindow: :allTransactionsDone() 
{ 

openAction->setEnabled(true) ; 
saveAction->setEnabled(true) ; 
saveAsAction->setEnabled(true) ; 

imageLabel->setPixmap(QPixmap: :f romImage(thread.image() ) ) ; 

setWindowModified(true) ; 

statusBar( ) ->showMessage(tr( "Ready" ) , 2000) ; 

} 

Le slot allTransactionsDone ( ) est appele quand la file d'attente de transactions de Tran- 
sactionThread se vide. 

Passons maintenant a la classe TransactionThread : 

class TransactionThread : public QThread 
{ 

Q_0BJECT 
public: 

void addTransaction(Transaction *transact); 
void setImage(const Qlmage Simage); 
Qlmage image( ) ; 
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signals: 

void transactionStarted(const QString &message); 

protected: 
void run(); 

private: 

QMutex mutex; 
Qlmage currentlmage; 
QQueue<Transaction *> transactions; 

}; 

La classe TransactionThread conserve une liste des transactions a gerer et les execute les 
unes apres les autres a l'arriere-plan. 

void TransactionThread: :addTransaction(Transaction "transact) 
{ 

QMutexLocker locker(&mutex) ; 
transactions. enqueue(transact) ; 
if ( !isRunning( ) ) 
startf) ; 

} 

La fonction addTransaction ( ) ajoute une transaction a la file d'attente des transactions et 
lance le thread de cette transaction s'il n'est pas deja en cours d'execution. Tous les acces a la 
variable membre transactions sont proteges par un mutex, le thread principal risquant de 
les modifier par l'intermediaire de addTransaction ( ) pendant que le thread secondaire 
parcourt transactions. 

void TransactionThread: :setImage(const Qlmage &image) 
{ 

QMutexLocker locker(&mutex) ; 
currentlmage = image; 

} 

Qlmage TransactionThread: :image() 
{ 

QMutexLocker locker(&mutex) ; 
return currentlmage; 

} 

Les fonctions set Image ( ) et image ( ) permettent au thread principal de definir l'image sur 
laquelle les transactions doivent etre effectuees et de recuperer l'image resultante une fois 
toutes les transactions terminees. Nous protegeons de nouveau les acces a une variable membre 
en utilisant un mutex. 



void TransactionThread: :run() 
{ 

Transaction "transact; 
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forever { 

mutex . lock ( ) ; 

if (transactions. isEmptyO) { 
mutex. unlock() ; 
break; 

} 

Qlmage oldlmage = currentlmage; 
transact = transactions. dequeue() ; 
mutex. unlock () ; 

emit transactionStarted(transact->message( ) ) ; 

Qlmage newlmage = transact->apply (oldlmage) ; 
delete transact; 

mutex. lock() ; 
currentlmage = newlmage; 
mutex. unlockf) ; 

} 

} 

La fonction run ( ) parcourt la file d'attente des transactions et les execute chacune tour a tour 
en appelant apply ( ) sur celles-ci. 

Quand une transaction est lancee, nous emettons le signal transactionStarted ( ) avec un 
message a afficher dans la barre d'etat de 1' application. Une fois le traitement de toutes les 
transactions termine, la fonction run ( ) se termine et QThread emet le signal finished ( ) . 

class Transaction 
{ 

public: 

virtual -Transaction ( ) { } 

virtual Qlmage apply(const Qlmage &image) = 0; 
virtual QString message() = 0; 

}; 

La classe Transaction est une classe de base abstraite pour les operations susceptibles d'etre 
effectuees par l'utilisateur sur une image. Le destructeur virtuel est necessaire, car nous devons 
supprimer les instances des sous-classes Transaction par le biais d'un pointeur Transaction. 
(Si nous l'omettons, certains compilateurs emettent un avertissement.) Transaction possede 
trois sous-classes concretes : FlipTransaction, ResizeTransaction et ConvertDepth- 
Transaction. Nous n'etudierons que FlipTransaction, les deux autres classes etant similaires. 

class FlipTransaction : public Transaction 
{ 

public: 

FlipTransaction (Qt: :Orientation orientation) ; 



Qlmage apply(const Qlmage &image); 
QString message() ; 
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private: 

Qt : :Orientation orientation; 

}; 

Le constructeur FlipTransaction recoit un parametre qui precise l'orientation de la rotation 
(horizontale ou verticale). 

Qlmage FlipTransaction: :apply(const Qlmage &image) 
{ 

return image. mirrored (orientation == Qt: horizontal, 
orientation == Qt :: Vertical) ; 

} 

La fonction apply ( ) appelle Qlmage : : mirrored ( ) sur le Qlmage recu en tant que parametre 
et retourne le Qlmage resultant. 

QString FlipTransaction: :message() 
{ 

if (orientation == Qt: horizontal) { 

return QObject : :tr( "Flipping image horizontally..."); 
} else { 

return QObject : :tr( "Flipping image vertically..."); 

} 

} 

La fonction message ( ) retourne le message a afficher dans la barre d'etat pendant la progres- 
sion de l'operation. Cette fonction est appelee dans TransactionThread : :run() lors de 
remission du signal transactionStarted ( ). 



Utiliser les classes Qt dans les threads secondaires 

Une fonction est dite thread-safe quand elle peut etre appelee sans probleme depuis plusieurs 
threads simultanement. Si deux fonctions thread-safe sont appelees depuis des threads diffe- 
rents sur la meme donnee partagee, le resultat est toujours defini. Par extension, une classe est 
dite thread-safe quand toutes ses fonctions peuvent etre appelees simultanement depuis des 
threads differents sans qu'il y ait d' interferences entre elles. 

Les classes thread-safe de Qt sont QMutex, QMutexLocker, QReadWriteLock, QReadLocker, 
QWriteLocker, QSemaphore, QThreadStorage<T>, QWaitCondition et certaines parties de 
l'API de QThread. En outre, plusieurs fonctions sont thread-safe, dont QObject: : connect ( ), 
QOb j ect : : disconnect ( ), QCoreApplication : : postEvent ( ), QCoreApplication : : remove- 
PostedEvent ( ) et QCoreApplication : : removePostedEvents ( ). 

La plupart des classes non GUI de Qt repondent a une exigence moins stricte : elles sont reentran- 
tes. Une classe est reentrante si differentes instances de la classe peuvent etre utilisees simulta- 
nement dans des threads differents. Cependant, l'acces simultane au meme objet reentrant dans 
plusieurs threads n'est pas securise, et un tel acces doit etre protege avec un mutex. Les classes 
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reentrantes sont marquees comme telles dans la documentation de reference Qt. En regie gene- 
rale, toute classe C++ ne faisant pas reference a une donnee globale ou partagee est reentrante. 

QOb j ect est reentrant, mais trois contraintes doivent etre prises en consideration : 

• Les QOb j ect enfants doivent etre crees dans le thread de leur parent. 

Ceci signifie que les objets crees dans un thread secondaire ne doivent jamais etre crees 
avec le meme objet QThread que leur parent, car cet objet a ete cree dans un autre thread 
(soit dans le thread principal, soit dans un thread secondaire different). 

• Nous devons supprimer tous les QOb] ect crees dans un thread secondaire avant d'envisager la 
suppression de l'objet QThread correspondant. 

Pour ce faire, nous pouvons creer les objets sur la pile dans QThread : : run ( ). 

• Les QOb j ect doivent etre supprimes dans le thread les ayant crees. 

Si nous devons supprimer un QOb j ect situe dans un thread different, nous devons appeler 
la fonction QObj ect : : deleteLater ( ), qui publie un evenement "deferred delete" 
(suppression differee). 

Les sous-classes QObj ect non GUI, telles que QTimer, QProcess et les classes de reseau, sont 
reentrantes. Nous pouvons les utiliser dans tout thread, ceci tant que ce thread possede une 
boucle d'evenement. En ce qui concerne les threads secondaires, la boucle d'evenement est 
demarree en appelant QThread: :exec() ou par des fonctions utilitaires telles que QPro- 
cess: : wait For Finished ( ) et QAbstractSocket : : waitForDisconnected ( ). 

QWidget et ses sous-classes ne sont pas reentrantes, a cause des limites heritees des biblio- 
theques sur lesquelles repose la prise en charge GUI de Qt. Par consequent, nous ne pouvons 
pas appeler directement des fonctions depuis un thread secondaire sur un widget. Pour chan- 
ger, par exemple, le texte d'un QLabel depuis un thread secondaire, nous pouvons emettre un 
signal connecte a QLabel : : setText ( ) ou appeler QMetaOb j ect : : invokeMethod ( ) depuis 
ce thread. Par exemple : 

void MyThread: :run() 
{ 

QMetaObj ect :: invokeMethod (label, SLOT(setText (const QString &)), 

Q_ARG(QString, "Hello")); 

} 

De nombreuses classes non GUI de Qt, dont Qlmage, QString et les classes conteneur, utili- 
sent le partage implicite comme technique d'optimisation. Bien que cette optimisation ne rende 
generalement pas une classe reentrante, ceci ne pose pas de probleme dans Qt. En effet, des 
instructions de langage assembleur atomiques sont employees pour implementer un decompte 
de references thread-safe, qui rend les classes implicitement partagees de Qt reentrantes. 

Le module QtSql de Qt peut egalement etre employe dans les applications multithread, mais il 
presente des restrictions qui varient d'une base de donnees a une autre. Vous trouverez plus de 
details a l'adresse http://doc.trolltech.eom/4.l/sql-driver.html. 
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Au sommaire de ce chapitre 

^ Developper Qt avec les plug-in 

^ Creer des applications capables 
de gerer les plug-in 

Ecrire des plug-in pour des 
applications 



Les bibliotheques dynamiques (egalement nominees bibliotheques partagees ou DLL) 
sont des modules independants stockes dans un fichier separe sur le disque et auxquels 
de multiples applications peuvent acceder. Les programmes specifient generalement les 
bibliotheques dynamiques qui leur sont necessaires au moment de la liaison, auquel cas 
ces bibliotheques sont automatiquement chargees lors du demarrage de 1' application. 
Cette approche implique generalement l'ajout de la bibliotheque ainsi que de son 
chemin d'acces d'inclusion au fichier .pro de l'application. En outre, les en-tetes 
adequats sont inclus dans les fichiers sources. Par exemple : 

LIBS += -ldb_cxx 

INCLUDEPATH += /usr/local/BerkeleyDB.4.2/include 

L alternative consiste a charger dynamiquement la bibliotheque quand elle est requise, puis 
a resoudre les symboles que nous souhaitons utiliser. Qt fournit la classe QLibrary pour y 
parvenir d'une maniere independante de la plate-forme. A partir d'un nom de bibliotheque, 
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QLibrary examine les emplacements standard sur la plate -forme en question a la recherche 
d'un fichier approprie. Pour le nom mimetype, par exemple, elle recherchera mimetype . dll 
sous Windows, mimetype . so sous Linux et mimetype . dylib sous Mac OS X. 
Les applications GUI modernes peuvent souvent etre developpees par l'emploi des plug-in. Un 
plug-in est une bibliotheque dynamique qui implemente une interface particuliere pour fournir 
une fonctionnalite supplementaire facultative. Par exemple, dans le Chapitre 5, nous avons 
cree un plug-in pour integrer un widget personnalise a Qt Designer. 

Qt reconnait son propre ensemble d'interfaces de plugin pour divers domaines, dont les formats 
d'image, les pilotes de bases de donnees, les styles de widgets, le codage du texte et l'accessi- 
bilite. La premiere section de ce chapitre explique comment developper Qt avec un plug-in. 
II est egalement possible de creer des plug-in specifiques a des applications Qt particulieres. Qt 
facilite l'ecriture de tels elements par le biais de sa structure de plug-in, qui securise egalement 
QLibrary contre les pannes etrend son utilisation plus aisee. Dans les deux dernieres sections 
de ce chapitre, nous vous montrerons comment creer une application qui prend en charge les 
plug-in et comment generer un plug-in personnalise pour une application. 

Developper Qt avec les plug-in 

Qt peut etre developpe avec plusieurs types de plug-in, les plus courants etant les pilotes 
de base de donnees, les formats d'images, les styles et les codecs de texte. Pour chaque type de 
plug-in, nous avons generalement besoin d'un minimum de deux classes : une classe wrapper 
(conteneur) de plug-in qui implemente les fonctions API generiques, et une ou plusieurs classes 
gestionnaires qui implementent chacune l'API d'un type de plug-in particulier. Les gestionnaires 
sont accessibles par le biais de la classe wrapper. (Voir Figure 19.1). 
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Figure 19.1 

Les classes gestionnaire et de plug-in de Qt (a V exception de Qtopia Core) 
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Pour illustrer ceci, nous allons implementer un plug-in capable de lire des fichiers curseur 
(fichiers .cur) Windows monochromes. Ces fichiers peuvent contenir plusieurs images du 
meme curseur a des tailles differentes. Une fois le plug-in de curseur cree et installe, Qt sera en 
mesure de lire les fichiers . cur et d'acceder aux curseurs individuels (par le biais de Qlmage, 
QlmageReader ou QMovie, par exemple). II pourra egalement convertir les curseurs en tout 
autre format de fichier d' image, tel que BMP, JPEG et PNG. Le plug-in pourrait aussi etre 
deploye avec les applications Qt, car elles controlent automatiquement les emplacements standard 
des plug-in Qt et chargent ceux qu' elles trouvent. 

Les nouveaux conteneurs de plug-in de format d'image doivent sous-classer QlmagelOPlugin 
et reimplementer quelques fonctions virtuelles : 

class CursorPlugin : public QlmagelOPlugin 
{ 

public: 

QStringList keys() const; 

Capabilities capabilities (QIODevice *device, 

const QByteArray &format) const; 
QlmagelOHandler *create(QIODevice *device, 

const QByteArray &format) const; 

}; 

La fonction keys( ) retourne une liste de formats d'image pris en charge par le plug-in. Le 
parametre format des fonctions capabilities ( ) et create ( ) est suppose avoir une valeur 
qui provient de cette liste. 

QStringList CursorPlugin: : keys () const 
{ 

return QStringList () « "cur"; 

} 

Notre plug-in ne prend en charge qu'un seul format d'image. II retourne done une liste avec un 
nom unique. Idealement, le nom doit etre l'extension de fichier utilisee pour ce format. Dans le 
cas de formats avec plusieurs extensions (telles que . j pg et . j peg pour JPEG), nous pouvons 
retourner une liste avec plusieurs entrees, chacune correspondant a une extension. 

QlmagelOPlugin: Capabilities 

CursorPlugin: :capabilities(QIODevice *device, 

const QByteArray &format) const 

{ 

if (format == "cur") 
return CanRead; 

if (format.isEmptyO) { 
CursorHandler handler; 
handler. setDevice(device) ; 
if (handler. canRead( ) ) 
return CanRead; 

} 

return 0; 

} 
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La fonction capabilities ( ) retourne ce que le gestionnaire d'image est en mesure d'accomplir 
avec le format d'image donne. II existe trois possibilites (CanRead, CanWrite et CanReadln- 
cremental), et la valeur de retour est un operateur de bits OR des possibilites qui s'appliquent. 

Si le format est "cur", notre implementation retourne CanRead. Si aucun format n'est fourni, 
nous creons un gestionnaire de curseur et verifions s'il est capable de lire les donnees depuis le 
peripherique en question. La fonction canRead() lit uniquement les donnees, essayant de 
determiner si elle reconnait le fichier, sans en changer le pointeur. Une possibility de 0 indique 
que ce gestionnaire ne peut ni lire ce fichier, ni y ecrire des donnees. 

QlmagelOHandler *CursorPlugin: : create (QIODevice *device, 

const QByteArray &format) const 

{ 

CursorHandler *handler = new CursorHandler; 
handler->setDevice(device) ; 
handler->setFormat (format) ; 
return handler; 

} 

Quand un fichier curseur est ouvert (par QlmageReader, par exemple), la fonction create ( ) 
du conteneur de plug-in est appelee avec le pointeur de peripherique et avec le format "cur". 
Nous creons une instance de CursorHandler et la configurons avec le peripherique et le format 
specifies. L appelant prend la propriete du gestionnaire et le supprimera quand il ne sera plus 
utile. Si plusieurs fichiers doivent etre lus, un nouveau gestionnaire peut etre cree pour chacun. 

Q_EXP0RT_PLUGIN2(cursorplugin, CursorPlugin) 

A la fin du fichier . cpp, nous utilisons la macro Q_EXP0RT_PLUGIN2 ( ) pour s'assurer que le 
plug-in est reconnu par Qt. Le premier parametre est un nom arbitraire que nous souhaitons 
attribuer au plug-in. Le second parametre est le nom de classe du plug-in. 

II est facile de sous-classer QlmagelOPlugin. Le travail veritable du plug-in est effectue dans 
le gestionnaire. Les gestionnaires de format d'image doivent sous-classer QlmagelOHandler 
et reimplementer ses fonctions publiques en totalite ou en partie. Commencons par l'en-tete : 

class CursorHandler : public QlmagelOHandler 
{ 

public: 

CursorHandler( ) ; 

bool canRead() const; 

bool read(QImage *image); 

bool jumpToNextImage( ) ; 

int currentImageNumber( ) const; 

int imageCountO const; 

private: 

enum State { BeforeHeader, Beforelmage, AfterLastlmage, Error }; 
void readHeaderlfNecessary ( ) const; 
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QBitArray readBitmap(int width, int height, QDataStream &in) const; 
void enterErrorStatej ) const; 

mutable State state; 
mutable int currentlmageNo; 
mutable int numlmages; 

}; 

Les signatures de toutes les fonctions publiques sont fixes. Nous avons omis quelques fonc- 
tions dont la reimplementation est inutile pour un gestionnaire en lecture seulement, en parti- 
culier write ( ). Les variables de membre sont declarees avec le mot-cle mutable, car elles 
sont modifiees a l'interieur des fonctions const. 

CursorHandler: :CursorHandler( ) 
{ 

state = BeforeHeader; 
currentlmageNo = 0; 
numlmages = 0; 

} 

Lors de la construction du gestionnaire, nous commencons par definir son etat. Nous appli- 
quons au premier curseur le numero d'image du curseur en cours. Ici, numlmage etant defini en 
0, il est evident que nous n'avons pas encore d'image. 

bool CursorHandler: :canRead() const 
{ 

if (state == BeforeHeader) { 

return device()->peek(4) == QByteArray ( " \0\0\2\0" , 4); 
} else { 

return state != Error; 

} 

} 

La fonction canRead( ) peut etre appelee a tout moment pour determiner si le gestionnaire 
d'images peut lire des donnees supplementaires depuis le peripherique. Si la fonction est appe- 
lee avant que nous ayons lu toute donnee et alors que nous nous trouvons toujours dans l'etat 
BeforeHeader, nous verifions la signature particuliere qui identifie les fichiers curseur 
Windows. Lappel QIODevice : : peek ( ) lit les quatre premiers octets sans changer le pointeur 
du fichier du peripherique. Si canRead() est appelee ulterieurement, nous retournons true 
quand aucune erreur ne s'est produite. 

int CursorHandler: :currentImageNumber( ) const 
{ 

return currentlmageNo; 

} 

Cette fonction retourne le numero du curseur au niveau duquel le pointeur de fichier du peri- 
pherique est positionne. Une fois le gestionnaire construit, il est possible pour l'utilisateur 
d'appeler toutes ses fonctions publiques, dans un ordre quelconque. C'est un probleme potentiel, 
car nous devons partir du principe que nous ne pouvons effectuer qu'une lecture sequentielle. 
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Nous devons done lire l'en-tete de fichier au moins une fois avant tout autre element. Nous 
resolvons le probleme en appelant la fonction readHeaderlf Necessary ( ). 

int CursorHandler: :imageCount( ) const 
{ 

readHeaderlf Necessary ( ) ; 
return numlmages; 

} 

Cette fonction retourne le nombre d' images dans le fichier. Pour un fichier valide oil aucune 
erreur de lecture ne s'est produite, elle retournera un decompte d'au moins 1 (voir 
Figure 19.2). 



Figure 19.2 
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| (size + 20) + 8 bytes| color table 




| width * height bytes| XOR bitmap 
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La fonction suivante est importante. Nous l'etudierons done par fragments : 

bool CursorHandler: :read(QImage *image) 
{ 

readHeaderlf Necessary ( ) ; 



if (state != Beforelmage) 
return false; 

La fonction read ( ) lit les donnees de toute image, en commencant a l'emplacement du poin- 
teur de peripherique courant. Nous pouvons lire 1' image suivante si l'en-tete du fichier est lu 
avec succes, ou apres qu'une image ait ete lue et que le pointeur de peripherique se deplace au 
debut d'une autre image. 

quint32 size; 

quint32 width; 

quint32 height; 

quint16 numPlanes; 

quint16 bitsPerPixel; 

quint32 compression; 



QDataStream in(device()) ; 
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in.setByteOrder(QDataStream: :LittleEndian) ; 

in » size; 

if (size != 40) { 

enterErrorStatef ) ; 

return false; 

} 

in » width » height » numPlanes » bitsPerPixel » compression; 
height /= 2; 

if (numPlanes != 1 | | bitsPerPixel != 1 | | compression != 0) { 
enterErrorStatef ) ; 
return false; 

} 

in.skipRawData( (size - 20) + 8); 

Nous creons un QDataStream pour lire le peripherique. Nous devons definir un ordre d'octets 
correspondant a celui mentionne par la specification de format de fichier .cur. II n'est pas 
besoin de definir un numero de version QDataStream, car le format de nombres entiers et de 
nombres a virgule flottante ne varie pas entre les versions de flux de donnees. Nous lisons 
ensuite les divers elements de l'en-tete du curseur. Nous passons les parties inutiles de l'en-tete 
et la table des couleurs de 8 octets au moyen de QDataStream: : skipRawData ( ). Nous 
devons revoir toutes les caracteristiques du format - par exemple en diminuant de moitie la 
hauteur car le format . cur fournit une hauteur qui est deux fois superieure a celle de l'image 
veritable. Les valeurs bitsPerPixel et compression sont toujours de 1 et de 0 dans un 
fichier . cur monochrome. Si nous rencontrons des problemes, nous pouvons appeler enter- 
ErrorState ( ) et retourner false. 

QBitArray xorBitmap = readBitmap(width, height, in); 
QBitArray andBitmap = readBitmap(width, height, in); 
if (in.status() != QDataStream: :0k) { 

enterErrorStatef ) ; 

return false; 

} 

Les elements suivants du fichier sont deux bitmaps, l'une etant un masque XOR et 1' autre un 
masque AND. Nous les lisons dans les QBitArray plutot que dans les QBitmap. Un QBitmap 
est une classe concue pour etre dessinee a l'ecran, mais ici, nous avons besoin d'un tableau 
d'octets ordinaire. Lorsque nous en avons fini avec la lecture du fichier, nous verifions l'etat du 
QDataStream. Cette operation fonctionne correctement, car si un QDataStream entre dans un 
etat d'erreur, il y reste et ne peut retourner que des zeros. Si, par exemple, la lecture echoue au 
niveau du premier tableau d'octets, la tentative de lecture du deuxieme resulte en un QBit- 
Array vide. 

*image = Qlmage (width, height, Qlmage: :Format_ARGB32) ; 

for (int i = 0; i < int(height); ++i) { 
for (int j = 0; j < int(width); { 
QRgb color; 
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int bit = (i * width) + j ; 

if (andBitmap.testBit(bit) ) { 
if (xorBitmap.testBit(bit) ) { 

color = 0X7F7F7F7F; 
} else { 

color = 0X00FFFFFF; 

} 

} else { 

if (xorBitmap.testBit(bit) ) { 

color = 0XFFFFFFFF; 
} else { 

color = 0xFF000000; 

} 

} 

image->setPixel( j , i, color); 

} 

} 

Nous construisons un nouveau Qlmage de la taille correcte et definissons image de facon qu'il 
pointe ver celui-ci. Puis nous parcourons chaque pixel des tableaux d'octets XOR et AND et nous 
les convertissons en specifications de couleur ARGB de 32 bits. Les tableaux d'octets AND et 
XOR sont utilises comme presente dans le tableau suivant pour obtenir la couleur de chaque 
pixel du curseur : 



AND 


XOR 


Resultat 


1 


1 


Pixel d'arriere-plan inverse 


1 


0 


Pixel transparent 


0 


1 


Pixel blanc 


0 


0 


Pixel noir 



Les pixels noirs, blancs et transparents ne presentent pas de probleme, mais il n'existe aucun 
moyen d'obtenir un pixel d'arriere-plan inverse au moyen d'une specification de couleur 
ARGB sans connaitre la couleur du pixel d' arriere-plan initial. En remplacement, nous utilisons 
une couleur grise semi-transparente (0x7F7F7F7F). 

++currentImageNo; 

if (currentlmageNo == numlmages) 

state = AfterLastlmage; 
return true; 

} 

Une fois la lecture de l'image terminee, nous mettons a jour le numero de l'image courante 
ainsi que l'etat si nous avons atteint la derniere image. A la fin de la fonction, le peripherique 
sera positionne au niveau de l'image suivante ou a la fin du fichier. 
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bool CursorHandler: : jumpToNextImage() 
{ 

Qlmage image; 
return read(&image) ; 

} 

La fonction j umpToNextlmage ( ) permet de passer une image. Pour des raisons de simplicite, 
nous appelons simplement read ( ) et ignorons le Qlmage resultant. Une implementation plus 
efficace consisterait a utiliser l'information stockee dans l'en-tete du fichier . cur pour passer 
directement a l'offset approprie dans le fichier. 

void CursorHandler: : readHeaderlf Necessary ( ) const 
{ 

if (state != BeforeHeader) 
return; 

quint16 reserved; 
quint16 type; 
quint16 count; 

QDataStream in (device ( ) ) ; 
in.setByteOrder(QDataStream: : LittleEndian) ; 

in » reserved » type » count; 
in.skipRawData(16 * count); 

if (in.status() != QDataStream: :0k || reserved != 0 
| | type != 2 | | count == 0) { 
enterErrorStatef) ; 
return; 

} 

state = Beforelmage; 
currentlmageNo = 0; 
numlmages = int(count) ; 

} 

La fonction privee readHeaderlf Necessary ( ) est appelee depuis imageCount ( ) et 
read( ). Si l'en-tete du fichier a deja ete lu, l'etat n'est pas BeforeHeader et nous rendons 
immediatement le controle. Dans le cas contraire, nous ouvrons un flux de donnees sur le peri- 
pherique, lisons quelques donnees generiques (dont le nombre de curseurs dans le fichier) et 
definissons l'etat en Beforelmage. Le pointeur de fichier du peripherique est positionne avant 
la premiere image. 

void CursorHandler: : enterErrorStatef) const 
{ 

state = Error; 
currentlmageNo = 0; 
numlmages = 0; 

} 



434 Qt4 et C++ : Programmation d'interfaces GUI 



Si une erreur se produit, nous supposons qu'il n'existe pas d'images valides et definissons 
l'etat en Error. L'etat du gestionnaire ne peut alors plus etre modifie. 

QBitArray CursorHandler: : readBitmapfint width, int height, 

QDataStream &in) const 



{ 



} 



QBitArray bitmapfwidth * height); 
quint8 byte; 
quint32 word; 

for (int i = 0; i < height; ++i) { 
for (int j = 0; j < width; ++j ) { 
if ((j % 32) == 0) { 
word = 0; 

for (int k = 0; k < 4; ++k) { 
in » byte; 

word = (word « 8) | byte; 

} 

} 

bitmap. setBitf ( (height - i - 1) * width) + j , 
word & 0x80000000) ; 

word «= 1 ; 

} 

} 

return bitmap; 



La fonction readBitmap( ) permet de lire les masques AND et XOR d'un curseur. Ces masques 
ont deux fonctions inhabituelles. En premier lieu, ils stockent les lignes de bas en haut, au lieu de 
l'approche courante de haut en bas. En second lieu, l'ordre des donnees apparait inverse par rapport 
a celui utilise a tout autre emplacement dans les fichiers .cur. Nous devons done inverser la 
coordonnee y dans l'appel de setBit ( ) , et nous lisons les valeurs bit par bit dans le masque. 

Nous terminons ici 1' implementation du plug-in de format d'image CursorHandler. Les 
plug-in correspondant a d'autres formats d'image doivent suivre le meme schema, bien que 
certains puissent implementer une part plus importante de l'API QlmagelOHandler, en parti- 
culier les fonctions utilisees pour ecrire les images. Les plug-in d'autres types, tels que les 
codecs de texte ou les pilotes de base de donnees, suivent le meme schema : un conteneur de 
plug-in fournit une API generique que les applications peuvent utiliser, ainsi qu'un gestion- 
naire fournissant les fonctionnalites sous-jacentes. 

Le fichier . pro differe entre les plug-in et les applications. Nous terminerons avec ceci : 

TEMPLATE = lib 

CONFIG += plugin 

HEADERS = cursorhandler.h \ 

cursorplugin.h 
SOURCES = cursorhandler.cpp \ 

cursorplugin.cpp 
DESTDIR = $(QTDIR) /plugins/imageformats 
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Par defaut, les fichiers . pro font appel au modele app, mais ici, nous devons utiliser le modele 
lib car un plug-in est une bibliotheque, et non une application autonome. La ligne CONFIG 
indique a Qt que la bibliotheque n'est pas classique, mais qu'il s'agit d'une bibliotheque de 
plug-in. DESTDIR mentionne le repertoire oil doit etre place le plug-in. Tous les plug-in Qt 
doivent se trouver dans le sous-repertoire plugins approprie oil a ete installe Qt, et comme 
notre plug-in fournit un nouveau format d' image, nous le placons dans le sous-repertoire 
plugins /imagef ormats. La liste des noms de repertoire et des types de plug-in est fournie a 
l'adresse http://doc.trolltech.eom/4.l/plugins-howto.html. Pour cet exemple, nous supposons 
que la variable d'environnement QTDIR est definie dans le repertoire oil est installe Qt. 

Les plug-in crees pour Qt en mode release et en mode debug sont differents. Ainsi, si les deux 
versions de Qt sont installees, il est conseille de preciser laquelle doit etre utilisee dans le 
fichier . pro, en ajoutant par exemple la ligne suivante : 

CONFIG += release 

Les applications qui utilisent les plug-in Qt doivent etre deployees avec ceux qu'elles sont 
sensees exploiter. Les plug-in Qt doivent etre places dans des sous-repertoires specifiques 
(imagef ormats, par exemple, pour les formats d'image). Les applications Qt recherchent les 
plug-in dans le sous-repertoire plugins situe dans le dossier oil reside leur executable. Ainsi, 
pour les plug-in d'image elles recherchent dans application_dir/plugins/image- 
f ormats. Si nous souhaitons deployer les plug-in Qt dans un repertoire different, les directions de 
recherche des plug-in peuvent etre multipliees en utilisant QCoreApplication : : add- 
LibraryPath ( ). 

Creer des applications capables de gerer 
les plug-in 

Un plug-in d' application est une bibliotheque dynamique qui implemente une ou plusieurs 
interfaces. Une interface est une classe qui est constitute exclusivement de fonctions purement 
virtuelles. La communication entre 1' application et les plug-in s'effectue par le biais de la table 
virtuelle de l'interface. Dans cette section, nous nous pencherons sur l'emploi d'un plug-in 
dans une application Qt par 1' intermediate de ses interfaces, et dans la section suivante nous 
verrons comment implementer un plug-in. 

Pour fournir un exemple concret, nous allons creer 1' application Text Art simple presentee en 
Figure 19.3. Les effets de texte sont fournis par les plug-in. L application recupere la liste des 
effets de texte fournis par chaque plug-in et les parcourt pour afficher chacun d'eux en tant 
qu'element dans un QListWidget (voir Figure 19.3). 

L application Text Art definit une interface : 

class TextArtlnterf ace 
{ 
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public: 

virtual -TextArtlnterf ace( ) { } 



virtual QStringList effects() const = 0; 

virtual QPixmap applyEf feet (const QString &effect, 

const QString tVtext, 

const QFont &font, const QSize &size, 

const QPen &pen, 

const QBrush &brush) = 0; 

}; 

Q_DECLARE_INTERFACE (TextArtlnterf ace , 

" com . software- inc . TextArt . TextArtlnterf ace / 1 . 0 " ) 



Figure 19.3 

L 'application Text Art 



Text Art TexS & 

Plain Outline 

Text Atrr Text Art 

Shadow 

Text Art 

BlgEnds 



OK Cancel 



Une classe d'interface declare normalement un destructeur virtuel, une fonction virtuelle qui 
retourne un QStringList ainsi qu'une ou plusieurs autres fonctions virtuelles. Le destructeur 
est avant tout destine a satisfaire le compilateur, qui, sans sa presence se plaindrait du manque 
de destructeur virtuel dans une classe possedant des fonctions virtuelles. Dans cet exemple, la 
fonction effects ( ) retourne une liste d'effets de texte fournis par le plug-in. Nous pouvons 
envisager cette liste comme une liste de cles. A chaque fois que nous appelons une autre fonc- 
tion, nous transmettons l'une de ces cles en tant que premier argument, permettant ainsi 
1' implementation d'effets multiples dans un plug-in. 

Nous faisons finalement appel a la macro Q_DECLARE_INTERFACE ( ) pour associer un identifi- 
cateur a l'interface. Cet identificateur comprend generalement quatre composants : un nom de 
domaine inverse specifiant le createur de l'interface, le nom de 1' application, le nom de l'inter- 
face et un numero de version. Des que nous modifions l'interface (en ajoutant une fonction 
virtuelle ou en changeant la signature d'une fonction existante), nous devons incrementer le 
numero de version. Dans le cas contraire, 1' application risque de tomber brusquement en panne 
en essayant d'acceder a un plug-in obsolete. 
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L' application est implemented dans une classe nommee TextArtDialog. Nous n'etudierons 
ici que le code presentant un interet. Commencons par le constructeur : 

TextArtDialog: :TextArtDialog(const QString &text, QWidget *parent) 
: QDialog(parent) 

{ 

listWidget = new QListWidget; 
listWidget->setViewMode(QListWidget: :IconMode) ; 
listWidget->setMovement (QListWidget: :Static) ; 
listWidget->setIconSize(QSize(260, 80) ) ; 

loadPlugins() ; 
populateListWidget(text) ; 

} 

Le constructeur cree un QListWidget pour repertorier les effets disponibles. II appelle la 
fonction privee loadPlugins() pour rechercher et charger tout plug-in implementant le 
TextArtlnterf ace et remplit le QListWidget en consequence, en appelant une autre fonction 
privee, populateListWidget ( ). 

void TextArtDialog: :loadPlugins() 
{ 

QDir pluginDir(QApplication : :applicationDirPath( ) ) ; 

#if defined (Q_0S_WIN) 

if (pluginDir.dirNameO .toLower() == "debug" 

|| pluginDir.dirName( ) -to-Lower ( ) == "release") 
pluginDir.cdUp() ; 
#elif defined (Q_0S_MAC) 

if (pluginDir.dirNameO == "Mac OS") { 
pluginDir.cdUp() ; 
pluginDir.cdllp() ; 
pluginDir.cdUp() ; 

} 

#endif 

if ( !pluginDir.cd( "plugins" ) ) 
return; 

foreach (QString fileName, pluginDir.entryList(QDir: :Files) ) { 
QPluginLoader loader(pluginDir.absoluteFilePath(fileName) ) ; 
if (TextArtlnterf ace interface = 

qobject_cast<TextArt Interface *> (loader. instance) ) ) ) 
interfaces. append(interface) ; 

} 

} 

Dans loadPlugins(), nous tentons de charger tous les fichiers du repertoire plugins de 
1' application. (Sous Windows, 1' executable de 1' application reside generalement dans un sous- 
repertoire debug ou release. Nous remontons done d'un niveau. Sous Mac OS X, nous 
prenons en compte la structure de repertoire du paquet.) 
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Si le fichier que nous essayons de charger est un plug-in qui utilise la meme version de Qt que 
1' application, QPluginLoader : :instance() retournera un QObject* qui pointe vers un 
plug-in Qt. Nous executons qobj ect_cast<T> ( ) pour verifier si le plug-in implemente le 
TextArt I interface. A chaque fois que la conversion est reussie, nous ajoutons 1' interface a la 
liste d'interfaces (de type QList<TextArtInterf ace*>) de TextArtDialog. 

Certaines applications peuvent vouloir charger plusieurs interfaces differentes, auquel cas le 
code permettant d'obtenir les interfaces doit etre similaire a celui-ci : 

QObject *plugin = loader. instancef) ; 

if (TextArtlnterface *i = qobj ect_cast<TextArtInterf ace *>(plugin)) 

textArtlnterfaces.append(i) ; 
if (BorderArtlnterf ace *i = qobj ect_cast<BorderArtInterf ace *>(plugin)) 

borderArtlnterfaces.append(i) ; 

if (Texturelnterface *i = qobj ect_cast<TextureInterf ace *>(plugin)) 
texturelnterfaces.append(i) ; 

Les memes plug-in peuvent etre convertis avec succes en plusieurs pointeurs d'interface, car il 
est possible pour les plug-in de fournir plusieurs interfaces avec 1' heritage multiple. 

void TextArtDialog: :populateListWidget(const QString &text) 
{ 

QSize iconSize = listWidget->iconSize( ) ; 
QPen pen(QColor( "darkseagreen" ) ) ; 

QLinearGradient gradients, 0, iconSize. width() / 2, 

iconSize. height () / 2); 
gradient. setColorAt(0.0, QColor( "darkolivegreen" ) ) ; 
gradient. setColorAt(0. 8, QColor( "darkgreen" ) ) ; 
gradient . setColorAt (1.0, QColor ( " lightgreen " ) ) ; 

QFont font("Helvetica", iconSize. height() , QFont: :Bold) ; 

foreach (TextArtlnterface *interface, interfaces) { 
foreach (QString effect, interf ace->effects( ) ) { 

QListWidgetltem *item = new QListWidgetItem(effect, 

listWidget) ; 

QPixmap pixmap = interface->applyEffect(effect, text, font, 

iconSize, pen, 
gradient) ; 

item->setData(Qt : :DecorationRole, pixmap) ; 

} 

} 

listWidget->setCurrentRow(0) ; 

} 

La fonction populateListWidget ( ) commence en creant quelques variables a transmette a 
la fonction applyEf f ect ( ), et en particulier un stylet, un degrade lineaire et une police. Elle 
parcourt ensuit le TextArtlnterface ayant ete trouve par loadPlugins ( ). Pour tout effet 
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fourni par chaque interface, un nouveau QListWidgetltem est cree avec le nom de l'effet 
qu'il represente, et un QPixmap est genere au moyen de applyEf f ect ( ). 

Dans cette section, nous avons vu comment charger des plug-in en appelant loadPlugins ( ) 
dans le constructeur, et comment les exploiter dans populateListWidget ( ). Le code deter- 
mine elegamment combien il existe de plug-in fournissant TextArtlnterf ace. En outre, des 
plug-in supplementaires peuvent etre ajoutes ulterieurement : a chaque nouvelle ouverture de 
P application, celle-ci charge tous les plug-in fournissant les interfaces souhaitees. II est ainsi 
possible de developper la fonctionnalite de Papplication sans pour autant la modifier. 

Ecrire des plug-in d'application 

Un plug-in d'application est une sous-classe de QOb j ect et des interfaces qu'il souhaite fournir. Le 
CD d' accompagnement de ce livre inclut deux plug-in pour Papplication Text Art presentee 
dans la section precedente. lis visent a demontrer que Papplication gere correctement plusieurs 
plug-in. 

Dans cet ouvrage, nous n'etudierons le code que de Pun d'entre eux, le plug-in Basic Effects. Nous 
supposerons que le code source du plug-in est situe dans un repertoire nomme basicef f ects- 
plugin et que Papplication Text Art se trouve dans un repertoire parallele nomme textart. 
Voici la declaration de la classe de plug-in : 

class BasicEff ectsPlugin : public QObject, public TextArtlnterf ace 
{ 

Q_0BJECT 

Q_INTERFACES(TextArtInterface) 
public: 

QStringList effects () const; 

QPixmap applyEf feet (const QString &effect, const QString &text, 
const QFont &font, const QSize &size, 
const QPen &pen, const QBrush &brush); 

}; 

Le plug-in n'implemente qu'une seule interface, TextArtlnterf ace. En plus de Q_OBJECT, 
nous devons utiliser la macro Q_INTERFACES( ) pour chaque interface sous-classee afin de 
nous assurer d'une cooperation sans problemes entre moc et qobj ect_cast<T> ( ). 

QStringList BasicEff ectsPlugin :: effects ( ) const 
{ 

return QStringList() « "Plain" « "Outline" « "Shadow"; 

} 

La fonction effects ( ) retourne une liste d'effets de texte pris en charge par le plug-in. Celui- 
ci supportant trois effets, nous retournons simplement une liste contenant le nom de chacun 
d'eux. 
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La fonction applyEf f ect ( ) fournit la fonctionnalite du plug-in et s'avere assez importante. 
C'est pourquoi nous l'etudierons par fragments. 

QPixmap BasicEffectsPlugin: :applyEffect(const QString &effect, 

const QString &text, const QFont &font, const QSize &size, 
const QPen &pen, const QBrush &brush) 

{ 

QFont myFont = font; 
QFontMetrics metrics (myFont) ; 
while ( (metrics. width(text) > size.widthf) 
|| metrics. height () > size.height()) 
&& myFont. pointSize() > 9) { 
myFont. setPointSize (myFont. pointSize() - 1); 
metrics = QFontMetrics(myFont) ; 

} 

Nous souhaitons nous assurer que le texte donne s'adaptera si possible a la faille specifiee. 
C'est la raison pour laquelle nous utilisons les metriques de la police arm de determiner si texte 
est trop gros pour s' adapter. Si tel est le cas, nous executons une boucle ou nous reduisons la taille 
en points jusqu'a parvenir a une dimension correcte, ou jusqu'a parvenir a 9 points, notre 
taille minimale fixee. 

QPixmap pixmap(size) ; 

QPainter painter(&pixmap) ; 
painter. setFont(myFont) ; 
painter. setPen(pen) ; 
painter. setBrush(brush) ; 

painter. setRenderHint(QPainter: Antialiasing, true) ; 
painter. setRenderHint(QPainter: :TextAntialiasing, true) ; 
painter. setRenderHint (QPainter: :SmoothPixmapTransform, true) ; 
painter. eraseRect (pixmap. rect ( ) ) ; 

Nous creons un pixmap de la taille requise et un painter pour peindre sur le pixmap. Nous defi- 
nissons aussi quelques conseils de rendu pour assurer les meilleurs resultats possible. L'appel a 
eraseRect () efface le pixmap avec la couleur d'arriere-plan. 

if (effect == "Plain") { 

painter. setPen(Qt: :NoPen) ; 
} else if (effect == "Outline") { 

QPen pen(Qt: :black) ; 

pen.setWidthF(2.5) ; 

painter. setPen(pen) ; 
} else if (effect == "Shadow") { 

QPainterPath path; 

painter. setBrush(Qt: :darkGray) ; 

path.addText( ( (size.widthf ) - metrics. width(text) ) / 2) + 3, 
(size. height () - metrics. descent()) + 3, myFont, 
text) ; 

painter. drawPath(path) ; 
painter. setBrush(brush) ; 

} 
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Pour l'effet "Plain" aucun relief n'est requis. En ce qui concerne l'effet "Outline", nous igno- 
rons le stylet initial et en creons un de couleur noire avec une largeur de 2,5 pixels. Quant a 
l'effet "Shadow", il nous faut d'abord dessiner l'ombre, de facon a pouvoir inscrire le texte 
par-dessus. 

QPainterPath path; 

path. addText( (size. width ( ) - metrics. width(text) ) / 2, 

size.heightf ) - metrics. descent( ) , myFont, text); 
painter. drawPath(path) ; 

return pixmap; 

} 

A present, nous disposons du stylet et de 1' ensemble des pinceaux adaptes a chaque effet de 
texte. Nous sommes maintenant prets a afficher le texte. Ce dernier est centre horizontalement 
et suffisamment eloigne du bas du pixmap pour laisser de la place aux hampes inferieures. 

Q_EXP0RT_PLUGIN2(basiceffectsplugin, BasicEffectsPlugin) 

A la fin du fichier .cpp, nous executons la macro Q_EXP0RT_PLUGIN2 ( ) afin de rendre le 
plug-in disponible pour Qt. 

Le fichier . pro est similaire a celui que nous avons utilise pour le plug-in de curseur Windows 
precedemment dans ce chapitre. 

TEMPLATE = lib 

CONFIG += plugin 

HEADERS = . . /textart/textartinterface.h \<RC>basiceffectsplugin.h 

SOURCES = basiceffectsplugin.cpp 

DESTDIR = . ./textart/plugins 

Si ce chapitre vous a donne l'envie d'en savoir plus sur les plug-in, vous pouvez etudier 
l'exemple plus avance Plug & Paint fourni avec Qt. L' application prend en charge trois inter- 
faces differentes et inclut une boite de dialogue Plugin Information repertoriant les plug-in et 
interfaces disponibles pour 1' application. 
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Au sommaire de ce chapitre 

1/ Construire une interface avec les API 
natives 

^ ActiveX sous Windows 

•/ Prendre en charge la gestion de session 
deXll 



Dans ce chapitre, nous allons etudier quelques options specifiques a la plate-forme 
disponibles pour les programmeurs Qt. Nous commencerons par examiner comment 
acceder aux API natives telles que 1' API Win32 de Windows, Carbon sous Mac OS X et 
Xlib sous XI 1. Nous etudierons ensuite l'extension ActiveQt, pour apprendre a utiliser 
les controles ActiveX sous Windows. Vous decouvrirez aussi que cette extension permet 
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de creer des applications qui se comportent comme des serveurs ActiveX. Dans la derniere 
section, nous expliquerons comment amener des applications Qt a cooperer avec le gestion- 
naire de session sous XI 1. 

Pour completer les fonctionnalites presentees ci-dessus, Trolltech offre plusieurs solutions Qt 
specifiques a la plate-forme, notamment les frameworks de migration Qt/Motif et Qt/MFC qui 
simplifient la migration des applications Motif/Xt et MFC vers Qt. Une extension analogue est 
fournie pour les applications Tcl/Tk par froglogic, et un convertisseur de ressource Microsoft 
Windows est disponible aupres de Klaralvdalens Datakonsult. Consultez les pages Web suivantes 
pour obtenir des details complementaires : 

• http: //www. trolltech. com/products/solutions/catalog/ 

• http://www.froglogic.com/tq/ 

• http://www.kdab.net/knut/ 

Pour tout ce qui concerne le developpement integre, Trolltech propose la plate -forme d' appli- 
cation Qtopia. Cette plate -forme est detaillee au Chapitre 21. 



Construire une interface avec les API natives 

L' API tres developpee de Qt repond a la plupart des besoins sur toutes les plates-formes, mais 
dans certaines circonstances, vous pourriez avoir besoin d' employer les API locales. Dans 
cette section, nous allons montrer comment utiliser ces API pour les differentes plates-formes 
prises en charge par Qt afin d'accomplir des taches particulieres. 



Figure 20.1 

Une fenetre d'outil 
Mac OS X avec la barre 
de titre sur le cote 




Options 
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B Hide This Window 



New Screenshot Save Sceenshot 



Sur toutes les plates-formes, QWidget fournit une fonction win Id ( ) qui renvoie l'identifiant 
de la fenetre ou le handle (descripteur). QWidget fournit aussi une fonction statique nommee 
find ( ) qui renvoie le QWidget avec un ID de fenetre particulier. Nous pouvons transmettre 
cet identifiant aux fonctions d' API natives pour obtenir des effets specifiques a la plate-forme. 
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Par exemple, le code suivant s'appuie sur winld ( ) pour deplacer la barre de titre d'une fenetre 
d'outil vers la gauche a l'aide des fonctions natives de Mac OS X : 

#ifdef Q_WS_MAC 

ChangeWindowAttributes(HIViewGetWindow(HIViewRef (toolWin. winld ( ) ) ) , 
kWindowSideTitlebarAttribute, 
kWindowNoAttributes) ; 

#endif 

Sous XI 1, voici comment nous pourrions modifier une propriete de fenetre : 
#ifdef Q_WS_X11 

Atom atom = XInternAtom(QX1 1 1nfo: :display ( ) , "MY_PROPERTY" , False); 
long data = 1 ; 

XChangeProperty (QX1 1 Inf o: :display ( ) , window->winId( ) , atom, atom, 
32, PropModeReplace, 
reinterpret_cast<uchar *>(&data), 1); 

#endif 

Les directives #if def et #endif qui encadrent le code specifique a la plate-forme garantissent 
la compilation de 1' application sur les autres plates-formes. 

Pour une application uniquement destinee a Windows, voici un exemple d'utilisation des 
appels de GDI pour afficher un widget Qt : 

void GdiControl: :paintEvent(QPaintEvent * /* event */) 
{ 

RECT rect; 

GetClientRect (winld () , &rect); 
HDC hdc = GetDC(winldO); 

FillRectfhdc, &rect, HBRUSH(C0L0R_WIND0W + 1)); 
SetTextAlign(hdC, TA_CENTER | TA_BASELINE) ; 

TextOutW(hdc, width () / 2, height() / 2, text.utf16() , text .size( ) ) ; 
ReleaseDC(winId( ) , hdc); 

} 

Pour que ce code s'execute, nous devons aussi reimplementer QPaintDevice : : paintEngine ( ) 
de sorte qu'elle renvoie un pointeur nul et definisse l'attribut Qt : : WA_PaintOnScreen dans 
le constructeur du widget. 

L' exemple suivant montre comment combiner QPainter et des appels GDI dans le gestion- 
naire d'evenement paint en executant les fonctions getDC ( ) et releaseDC ( ) : 

void MyWidget: :paintEvent(QPaintEvent * /* event */) 
{ 

QPainter painter(this) ; 

painter. fillRect(rect( ) .adjusted(20, 20, -20, -20), Qt::red); 
#ifdef Q_WS_WIN 

HDC hdc = painter. paintEngine()->getDC(); 

Rectangle(hdc, 40, 40, width () - 40, height)) - 40); 

painter .paintEngine ( )->releaseDC( ) ; 
#endif 
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Le melange des appels de QPainter avec les appels GDI comme dans ce code conduit quel- 
quefois a des resultats etranges, en particulier quand les appels de QPainter se produisent 
apres les appels GDI. En effet, QPainter s'appuie dans ce cas sur certaines hypotheses 
concernant l'etat de la couche de dessin sous-jacente. 

Qt definit un des quatre symboles de systeme de fenetre suivant : Q_WS_WIN, Q_WS_ X1 1, 
Q_WS_MAC, et Q_WS_QWS (Qtopia). Nous devons inclure au moins un en-tete Qt pour etre en 
mesure de les utiliser dans les applications. Qt fournit aussi des symboles de preprocesseur 
destines a identifier le systeme d' exploitation : 



• Q_OS_AIX 

• Q_0S_BSD4 

• Q_OS_BSDI 

• Q_OS_CYGWIN 

• Q_OS_DGUX 

• Q_OS_DYNIX 

• Q OS FREEBSD 



• Q_OS_HPUX 

• Q_0S_HURD 

• Q_0S_IRIX 

• Q_0S_LINUX 

• Q_0S_LYNX 

• Q_OS_MAC 

• Q OS NETBSD 



• Q_OS_OPENBSD 

• Q_0S_0S2EMX 

• Q_0S_0SF 

• Q_0S_QNX6 

• Q_0S_QNX 

• Q_0S_RELIANT 

• Q OS SCO 



• Q_OS_SOLARIS 

• Q_OS_ULTRIX 

• Q_OS_UNIXWARE 

• Q_0S_WIN32 

• Q OS WIN64 



Nous pouvons supposer qu'au moins un de ces symboles sera defini. Pour des raisons pratiques, 
Qt definit aussi Q_OS_WIN des que Win32 ou Win64 est detecte, et Q_OS_UNIX lorsqu'un 
systeme d' exploitation de type UNIX (y compris Linux et Mac OS X), est reconnu. Au moment de 
l'execution, nous pouvons controler QSysInfo: :WindowsVersion ou QSysInfo: : Macintosh- 
Version pour identifier les differentes versions de Windows (2000, XP, etc.) ou de Mac OS X 
(10.2, 10.3, etc.). 

Des macros de compilateur viennent completer les macros du systeme de fenetrage et du 
systeme d' exploitation. Par exemple, Q_CC_MSVC est definie si le compilateur est Microsoft 
Visual C++. Elles peuvent se reveler tres pratiques pour resoudre les erreurs de compilateur. 

Plusieurs classes de Qt liees a l'interface graphique fournissent des fonctions specifiques a la 
plate-forme qui renvoient des handles de bas niveau vers l'objet sous-jacent. Ces descripteurs 
sont enumeres en Figure 20.2. 

Sous XI 1, QPixmap : : x1 1 1nf o( ) et QWidget : : x1 1 1nfo ( ) renvoient un objet QX1 1 1nfo qui 
fournit divers pointeurs ou handles, tels que display ( ), screen ( ), colormap( ) et visual ( ). 
Nous pouvons les utiliser pour configurer un contexte graphique XI 1 sur un QPixmap ou un 
QWidget, par exemple. 

Les applications Qt qui doivent collaborer avec d'autres toolkits ou bibliotheques ont souvent 
besoin d'acceder aux evenements de bas niveau sous XI 1, MSGs sous Windows, EventRef 
sous Mac OS X, QWSEvents sous Qtopia) avant qu'ils ne soient convertis en QEvents. Nous 
pouvons proceder en derivant QAp plication et en reimplementant le filtre d'evenement 
specifique a la plate -forme approprie, c'est-a-dire x1 1 EventFilter ( ), winEventFilter ( ), 
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Figure 20.2 

Fonctions specifiques a la plate-forme pour acceder aux handles de has niveau 
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macEventFilter ( ), ou qwsEventFilter ( ). Nous pouvons aussi acceder aux evenements 
de plate-forme qui sont envoyes a un widget donne en reimplementant un des filtres 
x1 1 Event ( ), winEvent ( ), macEvent ( ), et qwsEvent ( ). Cela pourrait presenter de l'interet 
pour la gestion de certains types d'evenement qui seraient normalement ignores dans QT, 
comme les evenements de manette de jeu. 

Vous trouverez des informations complementaires concernant les details specifiques a chaque 
plate-forme, notamment comment deployer les applications Qt sur differentes plates-formes, a 
l'adresse http://doc.trolltech.eom/4.l/win-system.html. 

ActiveX sous Windows 

La technologie ActiveX de Microsoft permet aux applications d'incorporer des composants 
d' interface utilisateur fournis par d'autres applications ou bibliotheques. Elle est basee sur 
Microsoft COM et definit un jeu d'interfaces pour application qui emploie des composants et 
un autre jeu d'interfaces pour application et bibliotheque qui fournit les composants. 

La version Qt/Windows Desktop Edition fournit le Framework ActiveQt et combine de facon 
homogene ActiveX et Qt. ActiveQt est constitue de deux modules : 

• Le module QAxContainer nous permet d'utiliser les objets COM et d'integrer des controles 
ActiveX dans les applications Qt. 

• Le module QAxServer nous permet d'exporter des objets COM personnalises et des controles 
ActiveX ecrits avec Qt. 

Notre premier exemple va integrer l'application Windows Media Player dans une application 
Qt a l'aide du module QAxContainer. L'application Qt ajoute un bouton Open, un bouton 
Play / Pause, un bouton Stop et un curseur au controle ActiveX de Windows Media Player. 



Figure 20.3 

L'application Media 
Player 




La fenetre principale de l'application est de type PlayerWindow : 
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class PlayerWindow : public QWidget 
{ 

Q_0BJECT 

Q_ENUMS(ReadyStateConstants) 
public: 

enum PlayStateConstants { Stopped = 0, Paused = 1, Playing = 2 }; 
enum ReadyStateConstants { Uninitialized = 0, Loading = 1, 

Interactive = 3, Complete = 4 }; 

PlayerWindow( ) ; 

protected : 

void timerEventfQTimerEvent *event); 

private slots: 

void onPlayStateChange(int oldState, int newState); 
void onReadyStateChange(ReadyStateConstants readyState); 
void onPositionChange(double oldPos, double newPos); 
void sliderValueChangedfint newValue); 
void openFile( ) ; 

private: 

QAxWidget *wmp; 
QToolButton *openButton; 
QToolButton *playPauseButton; 
QToolButton *stopButton; 
QSlider *seekSlider; 
QString fileFilters; 
int updateTimer; 

}; 

La classe PlayerWindow herite de QWidget. La macro Q_ENUMS() (directement sous 
Q_OBJECT) est indispensable pour signaler a moc que le type ReadyStateConstants utilise 
dans le slot onReadyStateChange ( ) est un type enum. Dans la section privee, nous declarons 
la donnee membre QAxWidget*. 

PlayerWindow: : PlayerWindow( ) 
{ 

wmp = new QAxWidget; 

wmp->setControl("{22D6F312-B0F6-11D0-94AB-0080C74C7E95}") ; 

Dans le constructeur, nous commencons par creer un objet QAxWidget arm d'encapsuler le 
controle ActiveX Windows Media Player. Le module QAxContainer se compose de trois clas- 
ses : QAxObject englobe un objet COM, QAxWidget englobe un controle ActiveX, et 
QAxBase implemente la fonctionnalite COM pour QAxObj ect et QAxWidget. 

Nous appelons setControl( ) sur QAxWidget avec l'ID de la classe du controle Windows 
Media Player 6.4. Une instance du composant requis va ainsi etre creee. A partir de la, toutes 
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les proprietes, evenements, et methodes du controle ActiveX vont etre disponibles sous la 
forme de proprietes, signaux et slots Qt, par le biais de l'objet QAxWidget. 



Figure 20.4 
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Les types de donnees COM sont automatiquement convertis vers les types Qt correspondants, 
comme illustre en Figure 20.5. Par exemple, un parametre d'entree de type VARIANT_B00L 
prend le type bool, et un parametre de sortie de type VARIANT_B00L devient un type bool &. 
Si le type obtenu est une classe Qt (QString, QDateTime, etc.), le parametre d'entree est une 
reference const (par exemple, const QString &). 
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Figure 20.5 

Relations entre types COM et types Qt 
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Pour obtenir la liste de routes les proprietes, signaux et slots disponibles pour un QAxOb j ect 
ou un QAxWidget avec leurs types de donnees Qt, appelez QAxBase: : generateDocumen- 
t at ion ( ) ou faites appel a l'outil de ligne de commande deQtdumpdoc, que vous trouverez 
dans le repertoire tools \activeqt\dumpdoc de Qt. 

Examinons maintenant le constructeur de PlayerWindow : 
wmp->setProperty ( "ShowControls" , false) ; 

wmp->setSizePolicy(QSizePolicy : :Expanding, QSizePolicy: :Expanding) ; 
connect(wmp, SIGNAL(PlayStateChange(int, int)), 

this, SLOT(onPlayStateChange(int, int))); 
connect(wmp, SIGNAL(ReadyStateChange(ReadyStateConstants) ) , 

this, SLOT(onReadyStateChange(ReadyStateConstants) ) ) ; 
connectfwmp, SIGNAL(PositionChange(double, double)), 

this, SLOT(onPositionChange(double, double))); 

Apres l'appel de QAxWidget: : setControl( ), nous appelons QObject: : setProperty ( ) 
pour definir la propriete ShowControls du Windows Media Player en false, puisque nous 
fournissons nos propres boutons pour manipuler le composant. QObject: : setProperty ( ) 
peut etre utilisee a la fois pour les proprietes COM et pour les proprietes Qt normales. Son 
second parametre est de type QVariant. 

Nous appelons ensuite setSizePolicy() de sorte que le controle ActiveX occupe toute la 
place disponible dans la disposition, et nous connectons trois evenements ActiveX depuis 
le composant COM vers les trois slots. 

stopButton = new QToolButton; 
stopButton->setText (tr ( "&Stop" ) ) ; 
stopButton->setEnabled(false) ; 

connect(stopButton, SIGNAL(clicked( ) ) , wmp, SLOT(Stop() ) ) ; 

} 

La fin du constructeur PlayerWindow suit le modele habituel, sauf que nous connectons quelques 
signaux Qt aux slots fournis par l'objet COM (Play(), Pause (), et StopO). Les boutons 
etant analogues, nous ne presentons ici que 1' implementation du bouton Stop. 

II est temps d ' aborder la fonction timerEvent() : 

void PlayerWindow: :timerEvent(QTimerEvent *event) 
{ 

if (event->timerld() == updateTimer) { 

double curPos = wmp->property ( "CurrentPosition" ) . toDouble( ) ; 

onPositionChange(-1 , curPos); 
} else { 

QWidget: :timerEvent(event) ; 

} 

} 
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La fonction timerEvent ( ) est appelee a intervalles reguliers pendant la diffusion d'un clip. 
Nous l'employons pour faire avancer le curseur. Pour ce faire, nous appelons property ( ) sur 
le controle ActiveX arm d'obtenir la valeur de la propriete CurrentPosition en tant que 
QVariant et nous appelons toDouble( ) pour le convertir en double. Nous appelons alors 
onPositionChange ( ) pour realiser la mise a jour. 

La suite du code presente peu d'interet parce qu'elle ne concerne pas directement ActiveX et 
qu'elle ne comporte rien qui n'ait deja ete aborde. Le code complet est inclus sur le CD-ROM. 

Dans le fichier . pro, nous devons introduire l'entree suivante pour etablir une liaison avec le 
module QAxContainer : 

CONFIG += qaxcontainer 

Lorsqu'on gere des objets COM, on a souvent besoin d'appeler directement une methode 
COM (et pas seulement de la connecter a un signal Qt). La methode la plus simple de proceder 
est d'invoquer QAxBase: : dynamicCall( ) avec le nom et la signature de la methode en 
premier parametre et les arguments de cette derniere comme parametres supplementaires. 
Saisissez par exemple : 

wmp->dynamicCall( "TitlePlay(uint) " , 6) ; 

La fonction dy namicCall ( ) recoit jusqu'a huit parametres de type QVariant et renvoie un 
QVariant. Si nous avons besoin de transmettre un IDispatch* ou un IUnknown* de cette 
facon, nous pouvons encapsuler le composant dans un QAxOb j ect et appeler asVariant ( ) sur 
ce dernier pour le convertir en QVariant. Si nous avons besoin d'appeler une methode COM qui 
renvoie un IDispatch* ou un IUnknown*, ou si nous avons besoin d'acceder a une propriete 
COM appartenant a l'un de ces types, nous pouvons opter plutot pour querySubOb j ect ( ) : 

QAxObject *session = outlook. querySubObject( "Session" ) ; 
QAxObject *defaultContacts = 

session->querySubObject( "GetDef aultFolder(01Def aultFolders) " , 

"olFolderContacts" ) ; 

Si nous desirons appeler des methodes dont la liste de parametres contient des types de 
donnees non pris en charge, nous pouvons utiliser QAxBase : : querylnterf ace ( )pour recu- 
perer l'interface COM et appeler directement la methode. Comme toujours avec COM, nous 
devons appeler Release ( ) quand nous n'avons plus besoin de l'interface. S'il devient tres 
frequent d'avoir a appeler de telles methodes, nous pouvons deriver QAxObj ect ou QAxWidget 
et fournir des fonctions membres qui encapsulent les appels de l'interface COM. Vous ne devez 
pas ignorer que les sous classes QAxObject et QAxWidget ne peuvent pas definir leurs 
propres proprietes, signaux, ou slots. 

Nous allons maintenant detailler le module QAxServer. II nous permet de transformer un 
programme Qt standard en serveur ActiveX. Le serveur peut etre une bibliotheque partagee ou 
une application autonome. Les serveurs definis en tant que bibliotheques partagees sont 
souvent appeles serveurs in-process (in-process signifie "qui s'execute dans l'espace de traitement 
d'un client") ; les applications autonomes sont nominees serveurs hors processus. 
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Notre premier exemple de QAxServer est un serveur in-process qui fournit un widget affichant 
une bille qui se balance de gauche a droite. Nous allons aussi expliquer comment integrer le 
widget dans Internet Explorer. 

Voici le debut de la definition de classe du widget AxBouncer : 

class AxBouncer : public QWidget, public QAxBindable 
{ 

Q_0BJECT 

Q_ENUMS(SpeedValue) 

Q_PROPERTY(QColor color READ color WRITE setColor) 
Q_PROPERTY(SpeedValue speed READ speed WRITE setSpeed) 
Q_PROPERTY(int radius READ radius WRITE setRadius) 
Q_PROPERTY(bool running READ isRunning) 

AxBouncer herite a la fois de QWidget et QAxBindable. La classe QAxBindable fournit 
une interface entre le widget et un client ActiveX. Tout QWidget peut etre exporte sous forme 
de controle ActiveX, mais en derivant QAxBindable nous pouvons informer le client des 
changements de valeur d'une propriete, et nous pouvons implementer des interfaces COM 
pour completer celles deja implementees par QAxServer. 

Figure 20.6 

Le widget AxBouncer 
dans Internet Explorer 
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En presence d'heritage multiple impliquant une classe derivee de QOb j ect, nous devons toujours 
positionner la classe derivee de QOb j ect en premier de sorte que moc puisque la recuperer. 

Nous declarons trois proprietes de lecture-ecriture et une propriete en lecture seulement. La 
macro Q_ ENUMS ( ) est necessaire pour signaler a moc que le type SpeedValue est un type 
enum. L' enumeration est declaree dans la section publique de la classe : 

public: 

enum SpeedValue { Slow, Normal, Fast }; 
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AxBouncer(QWidget *parent = 0); 

void setSpeed(SpeedValue newSpeed); 

SpeedValue speed () const { return ballSpeed; } 

void setRadius(int newRadius); 

int radiusf) const { return ballRadius; } 

void setColorfconst QColor &newColor) ; 

QColor color() const { return ballColor; } 

bool isRunning() const { return myTimerld != 0; } 

QSize sizeHintj) const; 

QAxAggregated *createAggregate( ) ; 

public slots: 
void start)) ; 
void stop( ) ; 

signals: 

void bouncing( ) ; 

Le constructeur de Ax Bouncer est un constructeur standard pour un widget, avec un parametre 
parent. La macro QAXFACTORY_DEFAULT( ), que nous utiliserons pour exporter le composant, 
doit recevoir un constructeur avec sa signature. 

La fonction createAggregate ( ) est reimplementee dans QAxBindable. Nous l'etudierons 
un peu plus loin. 

protected: 

void paintEventfQPaintEvent *event); 
void timerEventfQTimerEvent *event); 

private: 

int intervallnMillisecondsf ) const; 

QColor ballColor; 
SpeedValue ballSpeed; 
int ballRadius; 
int myTimerld; 
int x; 
int delta; 

}; 

Les sections protegees et privees de la classe sont identiques a celles que nous aurions s'il 
s'agissait d'un widget Qt standard. 

AxBouncer: :AxBouncer(QWidget *parent) 
: QWidget(parent) 

{ 

ballColor = Qt: :blue; 
ballSpeed = Normal; 
ballRadius = 15; 
myTimerld = 0; 
x = 20; 
delta = 2; 

} 
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Le constructeur de AxBouncer initialise les variables privees de la classe. 

void AxBouncer: :setColor(const QColor &newColor) 
{ 

if (newColor != ballColor && requestPropertyChange( "color" ) ) { 
ballColor = newColor; 
update( ) ; 

propertyChanged( "color" ) ; 

} 

} 

La fonction setColor ( ) definie la valeur de la propriete color. Elle appelle update ( ) pour 
redessiner le widget. 

Les appels de requestPropertyChange ( ) et propertyChanged ( ) sont plus inhabituels. 
Ces fonctions derivent de QAxBindable et devraient normalement etre appelees a chaque fois 
que nous modifions une propriete. requestPropertyChange ( ) demande au client la permis- 
sion de changer une propriete, et renvoie true si le client accepte. La fonction property- 
Changed ( ) signale au client que la propriete a change. 

Les methodes d'acces de propriete setSpeed ( ) et setRadius ( ) suivent egalement ce modele, 
ainsi que les slots start() etstop(), puisqu'ils modifient la valeur de la propriete running. 

La fonction membre AxBouncer ne doit pas etre oubliee : 

QAxAggregated *AxBouncer: :createAggregate() 
{ 

return new ObjectSaf etylmpl; 

} 

La fonction createAggregate ( ) est reimplementee dans QAxBindable. Elle nous permet 
d'implementer les interfaces COM que le module QAxServer n'implemente pas deja ou de 
remplacer les interfaces COM par defaut de QAxServer. Ici, nous le faisons pour fournir 
l'interface IObj ectSaf ety, qui est celle a partir de laquelle Internet Explorer accede aux 
options de securite du composant. Voici l'astuce standard pour se debarrasser du fameux 
message d'erreur "Objet non securise pour le script" d'Internet Explorer. 

Voici la definition de la classe qui implemente l'interface IObj ectSaf ety : 

class ObjectSaf etylmpl : public QAxAggregated, public IObj ectSaf ety 
{ 

public: 

long queryInterface(const QUuid &iid, void **iface); 
QAXAGG_IUNKNOWN 

HRESULT WINAPI GetInterfaceSafetyOptions(REFIID riid, 

DWORD *pdwSupportedOptions, DWORD *pdwEnabledOptions) ; 
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HRESULT WINAPI Setlnterf aceSaf etyOptions (REFIID riid, 

DWORD pdwSupportedOptions, DWORD pdwEnabledOptions) ; 

}; 

Laclasse Ob j ectSaf etylmpl herite a la fois de QAxAggregated et de 10b j ectSaf ety. La 
classe QAxAggregated est une classe de base abstraite pour 1' implementation d'interfaces 
COM complementaires. L'objet COM etendu par QAxAggregated est accessible par le biais 
de controllingUn known ( ). Cet objet est cree en arriere-plan par le module QAxServer. 

La macro QAXAGG_I UNKNOWN fournit les implementations standard de Querylnterf ace ( ), 
AddRef (), et Release (). Ces implementations appellent simplement la meme fonction sur 
l'objet COM controleur. 

long Ob j ectSaf etylmpl: :queryInterface(const QUuid &iid, void **iface) 
{ 

* if ace = 0; 

if (iid == IID_IObjectSafety) { 

*iface = static_cast<IObj ectSaf ety *>(this); 
} else { 

return E_NOINTERFACE; 

} 

AddRef (); 
return S_OK; 

} 

La fonction querylnterf ace ( ) est une fonction virtuelle pure de QAxAggregated. Elle est 
appelee par l'objet COM controleur arm d'offrir l'acces aux interfaces fournies par la sous classe 
QAxAggregated. Nous devons renvoyer E_NOINTERFACE pour les interfaces que nous 
n'implementons pas et pour IUnknown. 

HRESULT WINAPI Ob] ectSaf etylmpl :: Getlnterf aceSaf etyOptions ( 
REFIID /* riid */, DWORD *pdwSupportedOptions, 
DWORD *pdwEnabledOptions) 

{ 

*pdwSupportedOptions = INTERFACESAFE_FOR_UNTRUSTED_DATA 

| INTERFACESAFE_FOR_UNTRUSTED_CALLER ; 
*pdwEnabledOptions = *pdwSupportedOptions; 
return S_OK; 

} 

HRESULT WINAPI Obj ectSaf etylmpl :: Setlnterf aceSaf etyOptions ( 
REFIID /* riid */, DWORD /* pdwSupportedOptions */, 
DWORD /* pdwEnabledOptions */) 

{ 

return S_OK; 

} 

Les fonctions Getlnterf aceSaf etyOptions ( ) et Setlnterf aceSaf etyOptions ( ) sont 
declarees dans IOb j ectSaf ety. Nous les implementons pour annoncer a tous que notre objet 
est bien securise pour les scripts. 
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Examinons maintenant main . cpp : 

#include <QAxFactory> 

#include "axbouncer.h" 

QAXFACTORY_DEFAULT(AxBouncer, 

" {5e2461 aa-a3e8-4f 7a-8b04-307459a4c08c} 
"{533af 1 1f-4899-43de-8b7f -2ddf588d1015} 
"{772c14a5-a840-4023-b79d-19549ece0cd9} 
" {dbcel e56-70dd-4f 74-85e0-95c65d86254d} 
"{3f3db5e0-78ff-4e35-8a5d-3d3b96c83e09} 



La macro QAXFACTORY_DEFAULT( ) exporte un controle ActiveX. Nous pouvons l'utiliser 
pour les serveurs ActiveX qui exportent un seul controle. L'exemple suivant de cette section 
montre comment exporter plusieurs controles ActiveX. 

Le premier argument destine a QAXFACTORY_DEFAULT ( ) est le nom de la classe Qt a exporter. 
C'est aussi le nom sous lequel le controle est exporte. Les cinq autres arguments sont l'ID de la 
classe, de 1' interface, de 1' interface de l'evenement, de la bibliotheque des types, et de 1' appli- 
cation. Nous pouvons generer ces identificateurs a l'aide d'un outil standard tel que guidgen 
ou uuidgen. Le serveur etant une bibliotheque, nous n'avons pas besoin de la fonction 
main( ). 

Voici le fichier . pro pour notre serveur ActiveX in-process : 

TEMPLATE = lib 

CONFIG += dll qaxserver 

HEADERS = axbouncer.h \ 

objectsafetyimpl.h 
SOURCES = axbouncer.cpp \ 

main. cpp \ 

objectsafetyimpl.cpp 
RC_FILE = qaxserver. rc 

DEF_FILE = qaxserver. def 

Les fichiers qaxserver . rc et qaxserver . def auxquels il est fait reference dans le fichier 
. pro sont des fichiers standards que Ton peut copier dans le repertoire src\ act iveqt\ control 
de Qt. 

Le make?le ou le fichier de projet Visual C++ genere par qmake contient les regies qui regis- 
sent l'enregistrement du serveur dans le registre de Windows. Pour enregistrer le serveur sur 
les machines utilisateur, nous pouvons faire appel a l'outil regsvr32 disponible sur tous les 
systemes Windows. 

Nous incluons alors le composant Bouncer dans une page HTML via la balise <ob j ect> : 

<object id="AxBouncer" 

Classid="clsid:5e2461aa-a3e8-4f7a-8b04-307459a4c08c"> 
<b>The ActiveX control is not available. Make sure you have built and 
registered the component server. </b> 
</object> 
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II est possible de creer des boutons qui invoquent des slots : 

<input type="button" value="Start" onClick="AxBouncer.start() "> 
<input type=" button" value="Stop" onClick="AxBouncer.stop() "> 

Nous pouvons manipuler le widget a l'aide de JavaScript ou VBScript comme n'importe quel 
autre controle ActiveX. Le fichier demo . html propose sur le CD presente une page rudimen- 
taire qui utilise le serveur ActiveX. 

Notre dernier exemple est une application Carnet d'adresse. Elle peut se comporter comme une 
application standard Qt/Windows ou comme un serveur ActiveX hors processus. Cette derniere 
option nous permet de creer le script de 1' application en Visual Basic, par exemple. 

class AddressBook : public QMainWindow 
{ 

Q_0BJECT 

Q_PROPERTY(int count READ count) 

Q_CLASSINFO("ClassID" , " {5881 41 ef -1 1 0d-4beb-95ab-ee6a478b576d} " ) 
Q_CLASSINFO(" Interfaced", "{718780ec-b30c-4d88-83b3-79b3d9e78502}") 
Q_CLASSINFO( "ToSuperClass" , "AddressBook" ) 

public: 

AddressBook(QWidget *parent = 0); 
-AddressBook( ) ; 

int count () const; 

public slots: 

ABItem *createEntry(const QString &contact); 
ABItem *f indEntry(const QString &contact) const; 
ABItem *entryAt(int index) const; 

private slots: 

void addEntry ( ) ; 
void editEntry(); 
void deleteEntry ( ) ; 

private: 

void createActions( ) ; 
void createMenus( ) ; 

QTreeWidget *treeWidget; 
QMenu *fileMenu; 
QMenu *editMenu; 
QAction *exitAction; 
QAction *addEntryAction; 
QAction *editEntryAction; 
QAction *deleteEntryAction; 

}; 
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Le widget AddressBook correspond a la fenetre principale de 1' application. La propriete et les 
slots fournis seront disponibles via le script. La macro Q_CLASSINFO ( ) permet de specifier la 
classe et les identiriants d' interface associes a cette derniere. Ceux-ci ont ete generes avec un 
outil tel que guid ou uuid. 

Dans l'exemple precedent, nous avions specifie la classe et les identifiants d'interface quand 
nous avions exporte la classe QAxBouncer a l'aide de la macro QAXFACTORY_DEFAULT( ). 
Dans cet exemple, nous allons exporter plusieurs classes, nous ne pouvons done pas executer 
QAXFACTORY_DEFAULT ( ). Nous avons deux options : 

• Deriver QAxFactory, reimplementer ses fonctions virtuelles pour fournir des informations 
concernant les types a exporter, et executer la macro QAXFACTORY_EXPORT( ) pour enregistrer 
le composant fabricant. 

• Executer les macros QAXFACTORY_BEGIN ( ), QAXFACTORY_END ( ) , QAXCLASS ( ) , et 
QAXTYPE ( ) pour declarer et enregistrer le composant fabricant. Cette approche exige de 
specifier la classe et ridentifiant d'interface a l'aide de Q_CLASSINFO( ). 

Voici la definition de la classe AddressBook : La troisieme occurrence de Q_CLASSINFO( ) 
pourrait vous sembler un peu bizarre. Par defaut, les controles ActiveX exposent non seule- 
ment leurs propres proprietes, signaux, et slots a leurs clients, mais aussi ceux de leurs super- 
classes jusqu'a QWidget. L'attribut ToSuperClass permet de specifier la superclasse de 
niveau superieur (dans l'arbre d' heritage) que nous desirons exposer. Nous specifions ici le 
nom de la classe du composant (AddressBook) en tant que classe de niveau le plus haut a 
exporter, ce qui signifie que les proprietes, signaux, et slots definis dans les superclasses 
d'AddressBook ne seront pas exportes. 

class ABItem : public QObject, public QTreeWidgetltem 
{ 

Q_0BJECT 

Q_PROPERTY(QString contact READ contact WRITE setContact) 
Q_PROPERTY( QString address READ address WRITE setAddress) 
Q_PROPERTY(QString phoneNumber READ phoneNumber WRITE setPhoneNumber) 
Q_CLASSINFO("ClassID", 11 {bc82730e-5f 39-4e5c-96be-461 c2cd0d282} " ) 
Q_CLASSINFO(" Interfaced", "{c8bc1656-870e-48a9-9937-fbe1ceff8b2e}") 
Q_CLASSINFO( "ToSuperClass" , "ABItem" ) 

public: 

ABItem(QTreeWidget *treeWidget) ; 
void setContact (const QString &contact); 
QString contact () const { return text(0); } 
void setAddress(const QString &address); 
QString address)) const { return text(1); } 
void setPhoneNumber(const QString &number); 
QString phoneNumberf ) const { return text(2); } 

public slots: 

void remove(); 

}; 
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La classe ABItem represente une entree dans le carnet d'adresses. Elle herite de QTreeWidget- 
Item pour pou voir etre affichee dans un QTreeWidget etdeQObject pour pou voir etre 
exportee sous forme d'objet COM. 

int mainfint argc, char *argv[]) 
{ 

QApplication app(argc, argv); 
if ( IQAxFactory: :isServer( ) ) { 

AddressBook addressBook; 

addressBook.show() ; 

return app.execf ) ; 

} 

return app.execf ) ; 

} 

Dans main(), nous verifions si 1' application s'execute en autonome ou en tant que serveur. 
L'option de ligne de commande -activex est reconnue par QApplication et execute 
1' application en tant que serveur. Si 1' application n'est pas executee de cette facon, nous creons 
le widget principal et nous l'affichons comme nous le ferions normalement pour une application 
Qt autonome. 

En complement de -activex, les serveurs ActiveX comprennent les options de ligne de 
commande suivantes : 

• - regserver enregistre le serveur dans le registre systeme. 
-unregserver annule 1 ' enregistrement du serveur dans le registre systeme. 

• -dumpidl file inscrit 1'IDL (Interface Definition Langage) du serveur dans le fichier 
specifie. 

Lorsque l'application s'execute en tant que serveur, nous devons exporter les classes Address- 
Book et ABItem en tant que composants COM : 

QAXFACTORY_BEGIN("{2b2b6f3e-86cf-4c49-9df5-80483b47f17b}", 
" {8e827b25- 1 48b-4307-ba7d-23f 27524481 8} " ) 
QAXCLASS ( Add ressBook ) 
QAXTYPE (ABItem) 
QAXFACTORY_END() 

Les macros precedentes exportent un composant fabricant d'objets COM. Puisque nous devons 
exporter deux types d'objets COM, nous ne pouvons pas nous contenter d'executer 
QAXFACTORY_DEFAULT ( ) comme nous l'avions fait dans l'exemple precedent. 

Le premier argument de QAXFACTORY_BEGIN( ) correspond a l'ID de bibliotheque de types ; 
le second est l'ID de l'application. Entre QAXFACTORY_BEGIN ( ) et QAX FACTOR Y_ END( ), 
nous specifions toutes les classes pouvant etre instanciees et tous les types de donnees qui ont 
besoin d'etre accessibles sous forme d'objets COM. 

Voici le fichier . pro pour notre serveur ActiveX hors processus : 

TEMPLATE = app 

CONFIG += qaxserver 
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HEADERS = abitem.h \ 

addressbook.h \ 

editdialog.h 
SOURCES = abitem.cpp \ 

addressbook.cpp \ 

editdialog.cpp \ 

main.cpp 
FORMS = editdialog.ui 

RC_FILE = qaxserver.rc 

Le fichier qaxserver . rc auquel il est fait reference dans le fichier . pro est un fichier standard 
que Ton peut copier dans le repertoire src\ act iveqt\ control de Qt. 

Cherchez dans le repertoire vb de l'exemple un projet Visual Basic qui utilise le serveur de 
carnet d'adresses. 

Nous en avons termine avec la presentation du framework ActiveQt. La distribution de Qt 
propose des exemples supplementaires, et la documentation contient des informations concer- 
nant la facon de creer les modules QAxContainer et QAxServer et comment resoudre les 
problemes d'interoperabilite courants. 



Prendre en charge la gestion de session X11 

Lorsque nous quittons XI 1, certains gestionnaires de fenetre nous demandent si nous desirons 
enregistrer la session. Si nous repondons oui, les applications en cours d'execution seront auto- 
matiquement redemarrees lors de la prochaine ouverture de session, au meme emplacement sur 
l'ecran et, cerise sur le gateau, dans le meme etat. 

Le composant XI 1 charge de l'enregistrement et de la restauration de la session est le gestion- 
naire de session. Pour qu'une application Qt/Xll puisse etre prise en charge par ce gestion- 
naire, nous devons reimplementer QApplication : :saveState() arm d' enregistrer l'etat de 
1' application. 



Figure 20.7 
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Windows 2000 et XP, et certains systemes Unix, proposent un autre mecanisme nomme Mise 
en veille. Des que l'utilisateur active la mise en veille, le systeme d' exploitation sauvegarde 
simplement la memoire de l'ordinateur sur disque puis la recharge au moment de la reactivation. 
Les applications ne sont pas sollicitees et n'ont pas besoin d'etre averties de l'operation. 

Lorsque l'utilisateur demande l'arret de l'ordinateur, nous pouvons prendre le controle juste 
avant l'execution de cette operation en reimplementant QApplication : : commitData ( ). 
Nous avons ainsi la possibility d'enregistrer toute donnee non sauvegardee et de dialoguer avec 
l'utilisateur si necessaire. Cette partie de la gestion de session est prise en charge sur les deux 
plates-formes XI 1 et Windows. 

Notre etude de la gestion de session va s'effectuer en analysant le code d'une application 
Tic-Tac-Toe compatible avec cette fonction. Commencons par examiner la fonction main ( ) : 

int mainfint argc, char *argv[]) 
{ 

Application app(argc, argv); 
TicTacToe toe; 
toe.setObjectName( "toe" ) ; 
app.setTicTacToe(&toe) ; 
toe.show( ) ; 
return app.execf) ; 



Nous creons un objet Application. La classe Application herite de QApplication et 
reimplemente a la fois commitData ( ) et saveState( ) arm de prendre en charge la gestion 
de session. 

Nous creons ensuite un widget TicTacToe, que nous associons a l'objet Application, puis 
nous l'affichons. Nous avons appele le widget TicTacToe. Nous devons attribuer des noms 
d' objet uniques aux widgets de niveau superieur si nous voulons que le gestionnaire de session 
soit en mesure de restaurer les tailles et positions des fenetres. 

Figure 20.8 Hg ^ffWBW— ■ ■5M 

L 'application Tic-Tac-Toe 



} 
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Voici la definition de la classe Application : 

class Application : public QApplication 
{ 

Q_0BJECT 
public: 

Application(int &argc, char *argv[]); 

void setTicTacToe(TicTacToe *tic); 

void saveState(QSessionManager &sessionManager) ; 

void commitData(QSessionManager SsessionManager) ; 

private: 

TicTacToe *ticTacToe; 

}; 

La classe Application stocke un pointeur vers le widget TicTacToe dans une variable 
privee. 

void Application: :saveState(QSessionManager &sessionManager) 
{ 

QString fileName = ticTacToe->saveState( ) ; 

QStringList discardCommand; 
discardCommand « "rm" « fileName; 
sessionManager.setDiscardCommand( discardCommand) ; 

} 

Sous XI 1, la fonction saveState( ) est appelee au moment ou le gestionnaire de session 
veux que 1' application enregistre son etat. La fonction est aussi disponible sur d'autres plates- 
formes, mais elle n'est jamais appelee. Le parametre QSessionManager nous permet de 
communiquer avec le gestionnaire de session. 

Nous commencons par demander au widget TicTacToe d'enregistrer son etat dans un 
fichier. Nous affectons ensuite une valeur a la commande d'annulation du gestionnaire. Cette 
commande est celle que le gestionnaire de session doit executer pour supprimer toute information 
stockee concernant l'etat courant. Pour cet exemple, nous la definissons en 

rm sessionfile 

ou sessionfile est le nom du fichier qui contient l'etat enregistre pour la session, et rm est 
la commande Unix standard pour supprimer des fichiers. 

Le gestionnaire de session comporte aussi une commande de redemarrage. II s'agit de celle 
que le gestionnaire execute pour redemarrer 1' application. Par defaut, Qt fournit la commande 
de redemarrage suivante : 

appname -session id_key 
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La premiere partie, appname, est derivee de argv[0]. Le composant id correspond a l'identi- 
fiant de session fourni par le gestionnaire de session; dont l'unicite est garantie au sein de 
plusieurs applications et de differentes executions de la meme application. La partie key est 
ajoutee arin d'identifier de facon unique l'heure a laquelle l'etat a ete enregistre. Pour diverses 
raisons, le gestionnaire de session peut appeler plusieurs fois saveState( ) au cours d'une 
meme session, et les differents etats doivent pouvoir etre distingues. 

Etant donne les limites des gestionnaires de session existants, nous devons nous assurer que le 
repertoire de 1' application se trouve dans la variable d'environnement PATH si nous voulons 
que 1' application puisse redemarrer correctement. Si vous desirez en particulier tester l'exem- 
ple Tic-Tac-Toe, vous devez l'installer dans le repertoire /usr/bin par exemple et l'invoquer 
en tapant tictactoe. 

Pour des applications simples, comme Tic-Tac-Toe, nous pourrions enregistrer l'etat sous 
forme d' argument de ligne de commande supplementaire de la commande de redemarrage. 
Par exemple : 

tictactoe -state OX-XO-X-0 

Ceci nous eviterait d' avoir a stacker les donnees dans un fichier puis a fournir une commande 
d'annulation pour supprimer le fichier. 

void Application: :commitData(QSessionManager &sessionManager) 
{ 

if (ticTacToe->gameInProgress() 

&& sessionManager.allowsInteraction()) { 
int r = QMessageBox: :warning(ticTacToe, tr( "Tic-Tac-Toe" ) , 
tr("The game hasn't finished . \n" 

"Do you really want to quit?"), 
QMessageBox: : Yes | QMessageBox: : Default, 
QMessageBox: :No | QMessageBox: : Escape) ; 
if (r == QMessageBox: : Yes) { 
sessionManager.releasef) ; 
} else { 

sessionManager.cancel() ; 

} 

} 

} 

La fonction commitData ( ) est appelee quand l'utilisateur ferme la session. Nous pouvons la 
reimplementer de sorte d'afficher un message d'avertissement qui signale a l'utilisateur le 
risque de perte de donnees. L implementation par defaut ferme tous les widgets de niveau le plus 
haut, ce qui donne le meme resultat que lorsque l'utilisateur ferme les fenetres l'une apres 
1' autre en cliquant sur le bouton de fermeture de leur barre de titre. Au Chapitre 3, nous avons 
vu comment reimplementer closeEvent ( ) pour detecter cette situation et afficher un message. 

Pour cet exemple, nous allons reimplementer commitData ( ) et afficher un message deman- 
dant a l'utilisateur de confirmer la fermeture de session si un jeu est en cours d'execution et si 
le gestionnaire de session nous permet de dialoguer avec l'utilisateur. Si l'utilisateur clique sur 
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Yes, nous appelons release ( ) pour ordonner au gestionnaire de poursuivre la fermeture de 
session ; s'il clique sur No, nous appelons cancel ( ) pour annuler l'operation. 



Figure 20.9 

"Vous desirez vraiment 
quitter ?" 



Tlc-Tac-Toe 



The game hasn't finished. 
Do you really want to quit? 



Yes 



No 



Examinons maintenant la classe TicTacToe : 

class TicTacToe : public QWidget 
{ 

Q_0BJECT 
public: 

TicTacToe (QWidget *parent = 0); 

bool gamelnProgressf ) const; 
QString saveState() const; 
QSize sizeHintf) const; 

protected: 

void paintEvent(QPaintEvent *event); 
void mousePressEvent(QMouseEvent *event); 

private: 

enum { Empty = Cross = 'X', Nought = '0' }; 

void clearBoard( ) ; 

void restoreStatef ) ; 

QString sessionFileName( ) const; 

QRect cellRectfint row, int column) const; 

int cellWidth() const { return width() / 3; } 

int cellHeightf) const { return height() / 3; } 

bool threeInARow(int rowl , int coll , int row3, int col3) const; 

char board[3] [3] ; 
int turnNumber; 

}; 

La classe TicTacToe herite de QWidget et reimplemente sizeHint( ), paintEvent( ), et 
mousePressEvent ( ). Elle fournit aussi les fonctions gamelnProgress ( ) et saveState ( ) 
que nous avions utilisees dans notre classe Application. 

TicTacToe: : TicTacToe (QWidget *parent) 
: QWidget(parent) 

{ 
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clearBoard() ; 

if (qApp->isSessionRestored( ) ) 
restoreState( ) ; 

setWindowTitle(tr( "Tic-Tac-Toe" ) ) ; 

} 

Dans le constructeur, nous effacons le tableau et si 1' application avait ete invoquee avec 
l'option - session, nous appelons la fonction privee restoreState ( ) pour recharger l'ancienne 
session. 

void TicTacToe: :clearBoard() 
{ 

for (int row = 0; row < 3; ++row) { 

for (int column = 0; column < 3; ++column) { 
board [row] [column] = Empty; 

} 

} 

turnNumber = 0; 

} 

Dans clearBoard ( ), nous effacons toutes les cellules et nous definissons turnNumber a 0. 

QString TicTacToe: :saveState() const 
{ 

QFile f ile(sessionFileName( ) ) ; 
if (file.open(QIODevice: :WriteOnly) ) { 
QTextStream out(&f ile) ; 
for (int row = 0; row < 3; ++row) { 

for (int column = 0; column < 3; ++column) 
out « board[row] [column] ; 

} 

} 

return file.fileNamef ) ; 

} 

Dans saveState ( ) , nous enregistrons l'etat du tableau sur disque. Le format est simple, avec 
'X' pour les croix, 'O' pour les ronds, et '-+-' pour les cellules vides. 

QString TicTacToe: :sessionFileName( ) const 
{ 

return QDir: :homePath() + "/.tictactoe_" + qApp->sessionId() + "_" 
+ qApp->sessionKey ( ) ; 

} 

La fonction privee sessionFileName() renvoie le nom de fichier pour l'ID et la cle de 
session en cours. Cette fonction est exploitee a la fois par saveState () et par restore- 
State ( ) . Le nom du fichier est constitue a partir de ces ID et cle de session. 

void TicTacToe: : restoreState ( ) 
{ 

QFile file(sessionFileName( ) ) ; 
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if (file.open(QIODevice: :ReadOnly) ) { 
QTextStream in(&file) ; 
for (int row = 0; row < 3; ++row) { 

for (int column = 0; column < 3; ++column) { 
in » board[ row] [column] ; 
if (board[row] [column] != Empty) 
++turnNumber; 

} 

} 

} 

updated ; 

} 

Dans restoreState ( ) , nous chargeons le fichier qui correspond a la session restauree et nous 
remplissons le tableau avec ces informations. Nous deduisons la valeur de turnNumber a 
partir du nombre de X et 0 sur le tableau. 

Dans le constructeur de TicTacToe, nous appelons restoreState ( ) lorsque QApplica- 
tion: : isSessionRestored ( ) renvoie true. Dans ce cas, sessionId() et sessionKeyO 
renvoient les memes valeurs que lorsque l'etat de l'application etait enregistre, et session- 
FileName ( ) renvoie le nom de fichier pour cette session. 

Les tests et le debogage de la gestion de session peuvent etre penibles, parce que vous devez 
continuellement vous connecter puis vous deconnecter. Un moyen d'eviter ces operations 
consiste a utiliser l'utilitaire standard xsm fourni avec XI 1. Le premier appel de xsm ouvre 
une fenetre du gestionnaire de session et un terminal. Les applications demarrees dans ce 
terminal vont toutes utiliser xsm comme gestionnaire de session plutot que celui du systeme. 
Nous pouvons alors nous servir de la fenetre de xsm pour terminer, redemarrer, ou supprimer 
une session, et voir si notre application se comporte normalement. Vous trouverez tous les 
details de cette procedure a l'adresse http://doc.trolltech.eom/4.l/session.html. 
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Programmation 
embarquee 




Au sommaire de ce chapitre 

Demarrer avec Qtopia 
Personnaliser Qtopia Core 



Le developpement des logiciels destines a s'executer sur des peripheriques mobiles tels 
que les PDA et les telephones portables presente des difficultes bien specifiques parce que 
les systemes embarques possedent generalement des processeurs plus lents, une capa- 
cite de memoire permanente reduites (memoire flash ou disque dur), moins de memoire 
et un ecran plus petit que les ordinateurs de bureau. 

Qtopia Core (precedemment nomme Qt/Embedded) est une version de Qt optimisee 
pour le systeme d' exploitation Linux embarque. Qtopia Core fournit les memes outils et 
la meme API que les versions de bureau de Qt (Qt/Windows, Qt/X 11 et Qt/Mac) 
completes des classes et outils requis pour la programmation embarquee. Par le biais 
d'une double licence, ce systeme est disponible a la fois pour le developpement open 
source et le developpement commercial. 
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Qtopia Core peut s'executer sur n'importe quel materiel equipe de Linux (notamment les 
architectures Intel x86, MIPS, ARM, StrongARM, Motorola 68000, et PowerPC). II comporte 
une memoire a" image et prend en charge un compilateur C++. Contrairement a Qt/Xl 1, il n'a 
pas besoin du systeme XWindow ; en fait, il implemente son propre systeme de fenetrage 
(QWS) ce qui permet d'optimiser au maximum la gestion des memoires. Pour reduire encore 
ses besoins en memoire, Qtopia Core peut etre recompile en excluant les fonctions non 
utilisees. Si les applications et composants exploites sur un peripherique sont connus par 
avance, ils peuvent etre compiles ensemble pour fournir un seul executable avec des liens statiques 
vers les bibliotheques de Qtopia Core. 

Qtopia Core beneficie egalement de diverses fonctionnalites qui existent aussi dans les 
versions bureau de Qt, notamment l'usage extensif du partage de donnees implicite ("copie 
lors de l'ecriture") pour ce qui concerne la technique d' optimisation de la memoire, la prise en 
charge des styles de widget personnalises via QStyle et un systeme de disposition qui s'adapte 
pour optimiser l'espace ecran disponible. 

Qtopia Core est au coeur de l'offre embarquee de Trolltech, qui comprend egalement Qtopia 
Platform, Qtopia PDA, et Qtopia Phone. Ces versions fournissent les classes et applications 
concues specifiquement pour les peripheriques portables et elles peuvent etre integrees avec 
plusieurs machines virtuelles Java tiers. 

Demarrer avec Qtopia 

Les applications de Qtopia Core peuvent etre developpees sur toute plate -forme equipee d'une 
chaine d'outils multiplate-forme. L' option la plus courante consiste a installer un compilateur 
croise GNU C++ sur un systeme UNIX. Ce processus et simplifie par un script et un ensemble 
de correctifs fournis par Dan Kegel a l'adresse http://kegel.com/crosstool/. Puisque Qtopia 
Core contient 1' API de Qt, il est generalement possible de travailler avec une version bureau de 
Qt, telle que Qt/Xl 1 ou Qt/Windows pour la plupart des developpements. 

Le systeme de configuration de Qtopia Core prend en charge les compilateurs croises, via 
l'option -embedded du script configure. Par exemple, pour obtenir une generation destinee 
a l'architecture ARM, vous devriez saisir 

./configure -embedded arm 

Nous avons la possibilite de creer des configurations personnalisees en ajoutant de nouveaux 
fichiers dans le repertoire mkspecs / qws de Qt. 

Qtopia Core dessine directement dans la memoire d'image de Linux (la zone de memoire asso- 
ciee avec l'affichage video). Pour acceder a cette memoire d'image, vous devrez accorder des 
permissions en ecriture au peripherique /dev/f b0. 

Pour executer les applications de Qtopia Core, nous devons commencer par demarrer un 
processus qui joue le role de serveur. Celui-ci est charge d'allouer des zones d' ecran aux clients 
et de generer les evenements de souris et de clavier. Toute application Qtopia Core peut devenir 
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serveur si vous specifiez -qws sur sa ligne de commande ou si vous transmettez QAppli- 
cation : :GuiServer comme troisieme parametre du constructeur de QApplication. 

Les applications client communiquent avec le serveur Qtopia Core par le biais de la memoire 
partagee. En arriere plan, les clients se dessinent eux-memes dans cette memoire partagee et 
sont charges d'afficher leurs propres decorations de fenetre. Cela permet d'obtenir un niveau 
de communication minimum entre les clients et le serveur tout en proposant une interface utili- 
sateur soignee. Les applications de Qtopia Core s'appuient normalement sur QPainter pour 
se dessiner elles-memes mais elles peuvent aussi acceder au materiel video directement a 
l'aide de QDirectPainter. 

Les clients ont la possibility de communiquer via le protocole QCOP. Un client peut ecouter sur 
un canal nomme en creant un objet QCopChannel et en se connectant a son signal received ( ) . 
Par exemple : 

QCopChannel *channel = new QCopChannel( "System" , this); 
connect(channel, SIGNAL(received(const QString &, const QByteArray &)), 
this, SLOT(received(const QString &, const QByteArray &))); 

Un message QCOP est constitue d'un nom et eventuellement d'un QByteArray. La fonction 
QCopChannel : : send ( ) statique diffuse un message sur le canal. Par exemple : 

QByteArray data; 

QDataStream out(&data, QIODevice: :WriteOnly) ; 
out « QDateTime: :currentDateTime() ; 

QCopChannel: :send( "System" , "clockSkew(QDateTime) " , data); 

Lexemple precedent illustre un idiome connu : nous nous servons de QDataStream pour 
coder les donnees, et pour garantir que le QByteArray sera correctement interprets par le 
destinataire, nous joignons le format de donnees dans le nom du message comme s'il s'agissait 
d'une fonction C++. 

Plusieurs variables d'environnement affectent les applications de Qtopia Core. Les plus impor- 
tantes sont QWS_MOUSE_PROTO et QWS_KEYBOARD, qui specifient le peripherique souris et le 
type de clavier. Vous trouverez une liste complete des variables d'environnement sur la page 
http://doc.trolltech.eom/4.l/emb-envvars. html. 

Si UNIX est la plate -forme de developpement, nous pouvons tester l'application en utilisant la 
memoire d'image virtuelle de Qtopia (qvf b), une application XI 1 qui simule pixel par pixel 
la memoire d'image reelle. Cela accelere considerablement le cycle de developpement. Pour 
activer la prise en charge de la memoire virtuelle dans Qtopia Core, vous transmettez 1' option 
-qvf b au script configure. N'oubliez pas que cette option n'est pas destinee a un usage en 
production. L'application de memoire d'image virtuelle se trouve dans le repertoire tools/ 
qvf b et peut etre invoquee de la facon suivante : 

qvfb -width 320 -height 480 -depth 32 

Une autre option qui fonctionne sur la plupart des plates-formes consiste a utiliser VNC 
( Virtual Network Computing) pour executer des applications a distance. Pour activer la prise en 
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charge de VNC dans Qtopia Core, vous transmettez l'option -qt-gfx-vnc a configure. 
Lancez ensuite vos applications Qtopia Core avec l'option de ligne de commande -display 
VNC : 0 et executez un client VNC qui pointe sur l'hote sur lequel vos applications s'executent. 
La taille et la resolution de l'ecran peuvent etre specifies en derinissant les variables d'environ- 
nement QWS_SIZE et QWS_DEPTH sur l'hote qui execute les applications Qtopia Core (par 
exemple, QWS_SIZE=320x480 et QWS_DEPTH=32). 

Personnaliser Qtopia Core 

A l'installation de Qtopia Core, nous pouvons specifier les fonctionnalites dont nous n'avons 
pas besoin afin de reduire l'occupation memoire. Qtopia Core comprend plus d'une centaine 
de fonctionnalites configurables, chacune etant associee a un symbole de preprocesseur. 
QT_N0_F I LED I ALOG, par exemple, exclut QFileDialog de la bibliotheque QtGui, et 
QT_N0_I18N renonce a la prise en charge de l'internationalisation. Les fonctionnalites sont 
enumerees dans le fichier src/ corelib/qf eatures . txt. 

Qtopia Core propose cinq configurations type (minimum, small, medium, large, et dist) qui 
sont stockees dans les fichiers src/corelib/qconf ig_xxx . h. Vous specifiez ces configurations 
via l'option -qconf ig xxx de configure, par exemple : 

./configure -qconf ig small 

Pour creer des configurations personnalisees, nous pouvons fournir manuellement un fichier 
qconf ig-xxx . h et l'utiliser comme s'il s'agissait d'une configuration standard. Nous pourrions 
aussi nous servir de l'outil graphique qconf ig, disponible dans le sous-repertoire tools de Qt. 

Qtopia Core propose les classes suivantes pour le dialogue avec les peripheriques d'entree et 
de sortie et pour personnaliser 1' aspect et le comportement du systeme de fenetrage : 



Classe 


Classe de base pour 


QScreen 


Pilotes d'ecran 


QScreenDriverPlugin 


plug-in de pilote d'ecran 


QWSMouseHandler 


Pilotes de souris 


QMouseDriverPlugin 


Plug-in de pilotes de souris 


QWSKeyboardHandler 


Pilotes de clavier 


QKbdDriverPlugin 


Plug-in de pilote de clavier 


QWSInputMethod 


Methodes d'entree 


QDecoration 


Styles de decoration de fenetre 


QDecorationPlugin 


Plug-in fournissant des styles de decoration de fenetre 
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Vous obtenez la liste des pilotes predefinis, des methodes d' entree, et des styles de decoration 
de fenetre en executant le script configure avec l'option -help. 

Vous speciriez le pilote video a l'aide de l'option de ligne de commande -display au demar- 
rage du serveur Qtopia Core, comme explique dans la section precedente, ou en definissant la 
variable d'environnement QWS_DI SPLAY. Vous specifiez le pilote de souris et le peripherique 
associe via la variable d'environnement QWS_MOUSE_PROTO, dont la valeur suit la syntaxe 
type : device, oil type est un des pilotes pris en charge et device le chemin d'acces au periphe- 
rique (par exemple, QWS_MOUSE_PRO-TO=IntelliMouse : /dev/mouse). Les claviers sont 
geres d'une facon analogue dans la variable d'environnement QWS_ KEYBOARD. Les methodes 
d' entree et decorations de fenetre sont definies par programme dans le serveur en executant 
QWSServer: : setCurrentlnputMethod ( ) et QApplication : : qwsSetDecoration ( ). 

Les styles de decoration de fenetre sont definis independamment du style de widget, qui herite 
de QStyle. II est tout a fait possible, par exemple, de definir Windows comme style de decora- 
tion de fenetre et Plastique comme style de widget. Si vous en avez envie, les decorations 
peuvent etre reglees fenetre par fenetre. 

La classe QWSServer fournit diverses fonctions pour personnaliser le systeme de fenetrage. 
Les applications qui s'executent en tant que serveurs Qtopia Core peuvent acceder a l'instance 
unique QWSServer via la variable globale qwsServer, initialisee dans le constructeur de 
QApplication. 

Qtopia Core prend en charge les formats de police suivants : TrueType (TTF), PostScript Type 
1, Bitmap Distribution Format (BDF), et Qt Pre-rendered Fonts (QPF). 

QPF etant un format brut, il est plus rapide et generalement plus compact que des formats 
vectoriels tels que TTF et Type 1 si le besoin se limite a une ou deux tailles differentes. L'outil 
makeqpf permet de creer des fichiers QPF a partir de fichiers TTF ou Type 1. Une autre solution 
consiste a executer nos applications avec l'option de ligne de commande -savef onts. 

Au moment d'ecrire ces lignes, Trolltech developpe une couche supplementaire au-dessus de 
Qtopia Core pour rendre le developpement des applications embarquees encore plus rapide et 
efficace. Une prochaine edition de cet ouvrage devrait contenir de plus amples informations a 
ce propos. 
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Installer Qt 

Au sommaire de ce chapitre 

i/ A propos des licences 
Installer Qt/Windows 

✓ Installer Qt/Mac 

✓ Installer Qt/X 11 

Cette annexe explique comment installer Qt sur votre systeme a partir du CD qui 
accompagne cet ouvrage. Ce CD comporte les editions de Qt 4.1.1 pour Windows, 
Mac OS X, et XI 1 (pour Linux et la plupart des versions d'Unix). Elles integrent toutes 
SQLite, une base de donnees du domaine public, ainsi qu'un pilote SQLite. Les editions 
de Qt fournies sur le CD vous sont proposees pour des raisons pratiques. Si vous envisa- 
gez serieusement le developpement logiciel, il est preferable de telecharger la derniere 
version de Qt a partir de http://www.trolltech.com/download/ ou d'acheter une 
version commercialisee. 

Trolltech fournit aussi Qtopia Core pour la creation d' applications destinees aux peri- 
pheriques embarques equipes de Linux tels que les PDA et les telephones portables. Si 
vous envisagez de creer des applications embarquees, vous pouvez obtenir Qtopia Core 
depuis la page Web de telechargement de Trolltech. 

Les exemples d'application etudies dans cet ouvrage se trouvent dans le repertoire 
examples du CD. De plus, Qt propose de nombreux petits exemples d'application dans 
le sous repertoire examples. 
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A propos des licences 

Qt est propose sous deux formes : open source et commerciale. Les editions open source sont 
disponibles gratuitement, alors que vous devez payer pour les editions commerciales. 

Le logiciel du CD convient pour creer des applications destinees a votre usage personnel ou 
pour votre formation. 

Si vous desirez distribuer les applications que vous allez creer avec la version Open source de 
Qt, vous devez respecter les termes et conditions de licence specifiques au logiciel que vous 
utilisez pour creer ces applications. Pour les editions Open source, ces termes et conditions 
impliquent 1' utilisation de la licence GNU General Public License (GPL). Les licences libres 
telles que la licence GPL accordent des droits aux utilisateurs des applications, notamment 
celui de visualiser et de modifier le code source et de distribuer les applications (sous les 
memes termes). Si vous desirez distribuer vos applications sans le code source ou si vous 
voulez appliquer vos propres conditions commerciales, vous devez acheter les editions 
commerciales du logiciel qui sert a creer vos applications. Ces editions vous permettent en 
effet de vendre et de distribuer vos applications sous vos propres termes. 

Le CD contient les versions GPL de Qt pour Windows, Mac OS X, et XI 1. Le texte legal 
complet des licences est inclus avec les packages sur le CD, ainsi que les informations concernant 
la facon d'obtenir les versions commerciales. 



Installer Qt/Windows 

Lorsque vous inserez le CD sur un ordinateur equipe de Windows, le programme d' installation 
devrait demarrer automatiquement. Sinon, ouvrez l'explorateur de fichiers pour localiser le 
repertoire racine du CD et double -cliquez sur install.exe. (II est possible que ce 
programme se nomme install selon la facon dont votre systeme est configure.) 

Si vous disposez deja du compilateur MinGW C++ vous devez preciser le repertoire dans 
lequel il est installe ; sinon cochez la case arm d'installer aussi ce programme. La version GPL 
de Qt fournie sur le CD ne fonctionnera pas avec Visual C++, vous devez done absolument 
installer MinGW si vous ne l'avez pas encore fait. Le programme d' installation vous propose 
egalement d'installer les exemples qui accompagnent cet ouvrage. Les exemples standard de 
Qt sont eux automatiquement installes ainsi que la documentation. 

Si vous choisissez d'installer le compilateur MinGW, vous constaterez certainement un delai 
entre la fin de l'installation de ce dernier et le debut de 1' installation de Qt. 

Apres l'installation, un nouveau dossier apparaitra dans le menu Demarrer intitule "Qt by 
Trolltech v4.1.1 (OpenSource)". Ce dossier propose des raccourcis vers Qt Assistant et Qt 
Designer, et un troisieme nomme "Qt 4.1.1 Command Prompt" qui demarre une fenetre de 
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console. Des que vous ouvrez cette fenetre, elle va definir les variables d'environnement pour 
la compilation des programmes Qt avec MinGW. C'est dans cette fenetre que vous allez executer 
qmakeetmake afin de generer vos applications Qt. 

Installer Qt/Mac 

Avant d'installer Qt sur Mac OS X, vous devez d'abord avoir installe le jeu d'outils Xcode 
Tools d'Apple. Le CD (ou le DVD) contenant ces outils est generalement fourni avec Mac OS 
X ; vous pouvez aussi les telecharger a partir du site Apple Developer Connection, a l'adresse 
http://developer.apple.com. 

Si vous travaillez avec Mac OS X 10.4 (Tiger) et Xcode Tools 2.x (avec GCC 4.0.x), vous 
pouvez executer le programme d' installation decrit precedemment. Si vous possedez une 
version plus ancienne de Mac OS X, ou une version plus ancienne de GCC, vous devrez instal- 
ler manuellement le package source. Celui-ci se nomme qt-mac-opensource- 
4 . 1 . 1 . tar . gz et il est stocks dans le dossier mac sur le CD. Si vous l'installez, suivez les 
instructions de la section suivante qui concernent l'installation de Qt sous XI 1. 

Pour executer le programme d' installation, inserez le CD et double -cliquez sur le package 
nomme Qt.mpkg. Le programme d'installation, Installer . app, va se lancer et Qt sera 
installe avec les exemples standard, la documentation, et les exemples associes a cet ouvrage. 
Cette installation s'effectue dans le repertoire /Developer, et les exemples du livre sont enre- 
gistres dans le repertoire /Developer/Examples/Qt4Book. 

Pour executer des commandes telles que qmake et make, vous devrez avoir recours a une fene- 
tre terminal, par exemple, Terminal . app dans /Applications/Utilities. Vous avez aussi 
la possibility de generer des projets Xcode a l'aide de qmake. Pour generer, par exemple, un 
projet Xcode pour l'exemple hello, demarrez une console telle que Terminal . app, placez- 
vous sur le repertoire /Developer/Examples/Qt4Book/chap01 /hello, puis saisissez la 
commande suivante : 

qmake -spec macx-xcode hello. pro 

Installer Qt/X11 

Pour installer Qt sur son emplacement par defaut sous XI 1, vous devez etre connecte en tant 
que root. Si vous n'avez pas ce niveau d'acces, specifiez l'argument -prefix de configure 
pour indiquer un repertoire dans lequel vous avez l'autorisation d'ecrire. 

1. Placez-vous sur un repertoire temporaire. Par exemple : 
cd /tmp 

2. Decompressez le fichier archive du CD : 
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cp /cdrom/x11/qt-x11-opensource-src-4.1 .1 .tgz . 
gunzip qt-x11-opensource-src-4.1 .1 .tgz 
tar xvf qt-x1 1 -opensource-src-4. 1 .1 .tar 

Vous allez ainsi creer le repertoire /tmp/qt-x1 1 -opensource-src-4. 1 . 1, en supposant 
que votre CD-ROM soit monte en /cdrom. Qt exige le logiciel GNU tar; qui se nomme 
gtar sur certains systemes. 

3. Executez l'outil configure avec vos options favorites afin de generer la bibliotheque de 
Qt et les outils qui accompagnent ce framework : 

cd /tmp/qt-x1 1 -opensource-src-4. 1 .1 
. /configure 

Vous pouvez executer . /configure -help pour obtenir une liste des options de configu- 
ration. 

4. Pour generer Qt, saisissez 
make 

Cette commande va creer la bibliotheque et compiler toutes les demos, les exemples et les 
outils. Sur certains systemes, make se nomme gmake. 

5. Pour installer Qt, saisissez 
su -c "make install" 

puis saisissez le mot de passe root. Ceci va installer Qt dans /usr/local/Troll-tech/ 
Qt-4 . 1 . 1 . Vous pouvez choisir un autre repertoire de destination via l'option -prefix de 
configure, et si vous disposez d'un acces en ecriture sur ce repertoire il vous suffit de 
saisir : 

make install 

6. Definissez certaines variables d'environnement pour Qt. 

Si vous travailler avec le shell bash, ksh, zsh, ou sh, ajoutez les lignes suivantes dans votre 
fichier . profile : 

PATH=/usr/local/Trolltech/Qt-4 . 1 . 1 /bin : $PATH 
export PATH 

Si vous travaillez avec le shell csh ou tcsh, ajoutez la ligne suivante dans votre fichier 
.login : 

setenv PATH /usr/local/Trolltech/Qt-4. 1 .1/bin:$PATH 

Si vous aviez precise -prefix avec configure, utilisez le chemin indique plutot que le 
chemin par defaut de la ligne precedente. 
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Si votre compilateur ne prend pas en charge rpath, vous devez aussi etendre la variable 
d'environnement LD_LIBRARY_PATHpourinclure/usr/local/ Trolltech/Qt-4. 1 . 1 /lib. 
Ce n'est pas necessaire sous Linux avec GCC. 

Qt est distribue avec une application de demonstration, qtdemo, qui exploite de nombreuses 
fonctionnalites de la bibliotheque. Elle represente un bon point de depart pour tester les 
possibilites de Qt. Vous pouvez consulter la documentation de Qt soit en visitant le site 
http://doc.trolltech.com, soit en executant Qt Assistant, 1' application d'aide de Qt, que vous 
obtenez en tapant assistant dans une fenetre console. 



B 



Introduction au 
langage C++ pour les 
programmeurs Java et C# 

Au sommaire de ce chapitre 

Demarrer avec C++ 

Principales differences de langage 

La bibliotheque C++ standard 

Cette annexe fournit une courte introduction au langage C++ pour les developpeurs qui 
connaissent deja Java ou C#. Nous supposons que vous maitrisez les concepts de 
l'oriente objet tels que 1' heritage et le polymorphisme, et que vous desirez etudier le 
C++. Pour ne pas transformer cet ouvrage en bible de 1500 pages qui couvrirait la tota- 
lite du langage C++, cette annexe vous livre uniquement l'essentiel. Elle presente les 
techniques et connaissances de base requises pour comprendre les programmes presen- 
ted dans le reste de cet ouvrage, avec suffisamment d' informations pour developper des 
applications graphiques C++ multiplateforme a l'aide de Qt. 

Au moment d'ecrire ces lignes, C++ est la seule option realiste pour ecrire des applica- 
tions graphiques orientees objet performantes, multiplateforme. Les detracteurs de ce 
langage soulignent generalement que Java et C#, qui ont abandonne la compatibilite 
avec le langage C, sont plus pratiques a utiliser ; en fait, Bjarne Stroustrup, l'inventeur 
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du C++, signale dans son ouvrage The Design and Evolution of C++ que "dans le langage 
C++, il y a beaucoup moins de difficultes de langage a eviter". 

Heureusement, lorsque nous programmons avec Qt, nous exploitons generalement un sous- 
ensemble de C++ qui est tres proche du langage utopique envisage par Stroustrup, ce qui nous 
laisse libre de nous concentrer sur le probleme immediat. De plus, Qt etend C++ sur plusieurs 
points de vue, par le biais de son mecanisme "signal et slot" innovant, de sa prise en charge 
d' Unicode et de son mot-cle fo reach. 

Dans la premiere section de cette annexe, nous allons voir comment combiner des fichiers de 
code source C++ afin d'obtenir un programme executable. Nous serons ainsi amenes a etudier 
les concepts de base de C++ tels que les unites de compilation, les fichiers d'en-tete, les 
fichiers d'objets, les bibliotheques et nous apprendrons a devenir familier avec le preprocesseur, 
le compilateur et l'editeur de liens C++. 

Nous examinerons ensuite les differences de langage les plus importantes entre C++, Java et C# : 
comment definir des classes, comment utiliser les pointeurs et references, comment surcharger les 
operateurs, comment utiliser le preprocesseur et ainsi de suite. Meme si la syntaxe de C++ semble 
analogue a celle de Java ou C# au premier abord, les concepts sous-jacents different de facon 
subtile. D' autre part, en tant que source d' inspiration pour Java et C#, le langage C++ comporte 
de nombreux points communs avec ces deux langages, notamment les types de donnees simi- 
laires, les memes operateurs arithmetiques et les memes instructions de controle de flux de base. 

La derniere section est dediee a la bibliotheque C++ standard qui fournit une fonctionnalite pret a 
l'emploi que vous pouvez exploiter dans tout programme C++. Cette bibliotheque resulte de plus 
de 30 annees de developpement, et en tant que telle fournit une large gamme d'approches compre- 
nant les styles de programmation procedural, oriente objet, et fonctionnel, ainsi que des macros 
et des modeles. Comparee aux bibliotheques Java et C#, la portee de la bibliotheque C++ stan- 
dard est relativement limitee ; elle ne fournit aucun support au niveau de l'interface graphique 
GUI, de la programmation multithread, des bases de donnees, de l'internationalisation, de la gestion 
de reseau, XML et Unicode. Pour etendre la portee de C++ dans ces domaines, les developpeurs 
C++ doivent avoir recours a diverses bibliotheques (souvent specifiques a la plate -forme). 

C'est a ce niveau que Qt apporte son bonus. Qt a demarre comme "boite a outils" GUI multi- 
plateforme (un ensemble de classes qui permettent d'ecrire des applications a interface utilisa- 
teur graphique portables) mais qui a rapidement evolue en framework a part entiere qui etend 
et remplace partiellement la bibliotheque C++ standard. Bien que cet ouvrage traite de Qt, il 
est interessant de connaitre ce que la bibliotheque C++ standard a a offrir, puisque vous risquez 
d' avoir besoin de travailler avec du code qui 1' utilise. 

Demarrer avec C++ 

Un programme C++ est constitue d'une ou plusieurs unites de compilation. Chacune de ces 
unites est un fichier de code source distinct, typiquement avec une extension .cpp (les autres 
extensions courantes sont . cc et . cxx) que le compilateur traite dans le meme cycle d'execution. 
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Pour chaque unite de compilation, le compilateur genere un fichier objet, avec 1' extension 
. ob j (sous Windows) ou . o (sous Unix et Mac OS X). Le fichier objet est un fichier binaire 
qui contient le code machine destine a 1' architecture sur laquelle le programme va s'executer. 

Une fois que les fichiers . cpp ont ete compiles, nous pouvons combiner les fichiers objet fin de 
creer un executable a l'aide d'un programme particulier nomme editeur de liens. Cet editeur 
de liens concatene les fichiers objet et resout les adresses memoire des fonctions et autres 
symboles auxquels font reference les unites de compilation. 
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Lorsque vous generez un programme, une seule unite de compilation doit contenir la fonction 
main( ) qui joue le role de point d' entree dans le programme. Cette fonction n'appartient a 
aucune classe; il s'agit d' une fonction globale. 

Contrairement a Java, pour lequel chaque fichier source doit contenir une classe exactement, 
C++ nous laisse libre d'organiser nos unites de compilation. Nous avons la possibility d'imple- 
menter plusieurs classes dans le meme fichier .cpp, ou de repartir 1' implementation d'une 
classe dans plusieurs fichiers . cpp. Nous pouvons aussi choisir n'importe quel nom pour nos 
fichiers source. Quand nous effectuons une modification dans un fichier . cpp particulier, il 
suffit de recompiler uniquement ce fichier puis d'executer de nouveau 1' editeur de liens sur 
application pour creer un nouvel executable. 

Avant de poursuivre, examinons rapidement le code source d'un programme C++ tres simple 
qui calcule le carre d'un entier. Le programme est constitue de deux unites de compilation : 
main . cpp et square . cpp. 

Voici square . cpp : 

1 double square(double n) 

2 { 

3 return n * n; 

4 } 

Ce fichier contient simplement une fonction globale nommee square ( ) qui renvoie le carre de 
son parametre. 

Voici main . cpp : 

1 #include <cstdlib> 

2 #include <iostream> 
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3 using namespace std; 

4 double square(double) ; 

5 int main(int argc, char *argv[]) 

6 { 

7 if (argc != 2) { 

8 cerr « "Usage: square <number>" « endl; 

9 return 1 ; 

10 } 

11 double n = strtod(argv[1 ] , 0); 

12 cout « "The square of " « argv[1] « " is " « square(n) « endl; 

13 return 0; 

14 } 

Le fichier source de main . cpp contient la definition de la fonction main ( ) . En C++, cette fonc- 
tion recoit en parametres un int et un tableau de char* (un tableau de chaines de caracteres). 
Le nom du programme est disponible en tant que argv[0] et les arguments de ligne de 
commande en tant que argv [ 1 ] , argv [2] , argv[argc -1 ]. Les noms de parametre argc 
("nombre d'arguments") et argv ("valeurs des arguments") sont conventionnels. Si le 
programme n'a pas acces aux arguments de ligne de commande, nous pouvons definir main ( ) 
sans parametre. 

La fonction main() utilise strtod() ("string to double"), cout (flux de sortie standard de 
C++), et cerr (flux d'erreur standard du C++) de la bibliotheque Standard C++ pour convertir 
1' argument de ligne de commande en double puis pour afficher le texte sur la console. Les 
chaines, les nombres, et les marqueurs de fin de ligne (endl) sont transmis en sortie a l'aide de 
l'operateur «, qui est aussi utilise pour les operations avec decalage des bits. Pour obtenir 
cette fonctionnalite standard, il faut coder les deux directives #include des lignes 1 et 2. 

La directive using namespace de la ligne 3 indique au compilateur que nous desirons impor- 
ter tous les identificateurs declares dans l'espace de noms std da528ns l'espace de noms 
global. Cela nous permet d'ecrire strtod(), cout, cerr, et endl plutot que les versions 
completement qualifiers std : : strtod ( ), std : : cout, std : : cerr, et std : : endl. En C++, 
l'operateur : : separe les composants d'un nom complexe. 

La declaration de la ligne 4 est un prototype de fonction. Elle signale au compilateur qu'une 
fonction existe avec les parametres et la valeur de retour indiques. La fonction reelle peut se 
trouver dans la meme unite de compilation ou dans une autre. En 1' absence de ce prototype, 
le compilateur aurait refuse l'appel de la ligne 12. Les noms de parametre dans les prototypes de 
fonction sont optionnels. 

La procedure de compilation du programme varie d'une plate-forme a l'autre. Pour compiler sur 
Solaris, par exemple, avec le compilateur C++ de Sun, il faudrait taper les commandes suivantes : 



CC -c main. cpp 

CC -c square. cpp 

Id main.o square. o -o square 
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Les deux premieres lignes invoquent le compilateur afin de generer les fichiers . o pour les 
fichiers .cpp. La troisieme ligne invoque l'editeur de liens et genere un executable nomme 
square, que nous pouvons ensuite appeler de la facon suivante : 

. /square 64 

Le programme affiche le message suivant sur la fenetre de console : 

The square of 64 is 4096 

Pour compiler le programme, vous preferez peut -etre obtenir l'aide de votre gourou C++ 
local. Si vous n'y parvenez pas, lisez quand meme la suite de cette annexe sans rien compiler et 
suivez les instructions du Chapitre 1 pour compiler votre premiere application C++/Qt. Qt 
fournit des outils a partir desquels il n'est pas difficile de generer des applications pour 
n'importe quelle plate-forme. 

Revenons a notre programme. Dans une application du monde reel, nous devrions normale- 
ment placer le prototype de la fonction square ( ) dans un fichier separe puis inclure ce fichier 
dans toutes les unites de compilation dans lesquelles nous avons besoin d' appeler la fonction. 
Un tel fichier est nomme fichier d'en-tete et il comporte generalement l'extension .h (.hh, 
. hpp, et . hxx sont egalement courantes). Si nous reprenons notre exemple avec la methode du 
fichier d'en-tete, il faudrait creer le fichier square . h avec le contenu suivant : 

1 #ifndef SQUAREJH 

2 #define SQUAREJH 

3 double square(double) ; 

4 #endif 

Le fichier d'en-tete reunit trois directives de preprocesseur (#if ndef , #def ine, et #endif). 
Elles garantissent que le fichier sera traite une seule fois, meme si le fichier d'en-tete est inclus 
plusieurs fois dans la meme unite de compilation (une situation que Ton retrouve lorsque des 
fichiers d'en-tete incluent d'autres fichiers d'en-tete). Par convention, le symbole de preproces- 
seur utilise pour obtenir ce resultat est derive du nom de fichier (dans notre exemple, 
SQUARE_H). Nous reviendrons au preprocesseur un peu plus loin dans cette annexe. 

Voici la syntaxe du nouveau fichier main . cpp : 

1 #include <cstdlib> 

2 #include <iostream> 

3 #include "square. h" 

4 using namespace std; 

5 int main(int argc, char *argv[]) 

6 { 

7 if (argc != 2) { 

8 cerr « "Usage: square <number>" « endl; 

9 return 1 ; 
10 } 
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11 double n = strtod(argv[1] , 0); 

12 cout « "The square of " « argv[1] « " is " « square(n) « endl; 

13 return 0; 

14 } 

La directive #include en ligne 3 insere a cet endroit le contenu du fichier square. h. Les 
directives qui debutent par un # sont prises en charge par le preprocesseur C++ avant meme 
le debut de la compilation. Dans le temps, le preprocesseur etait un programme separe que le 
programmeur invoquait manuellement avant d'executer le compilateur. Les compilateurs 
modernes gerent desormais implicitement l'etape du preprocesseur. 

Les directives #include en lignes 1 et 2 inserent le contenu des fichiers d'en-tete cstdlib et 
iostream, qui font partie de la bibliotheque C++ standard. Les fichiers d'en-tete standard 
n'ont pas de suffixe . h . Les crochets (< >) autour des noms de fichier indiquent que les 
fichiers d'en-tete se situent a un emplacement standard sur le systeme, alors que les guillemets 
doubles indiquent au compilateur qu'il doit examiner le repertoire courant. Les inclusions sont 
normalement inserees au debut du fichier . cpp. 

Contrairement aux fichiers . cpp, les fichiers d'en-tete ne sont pas des unites de compilation a 
proprement parler et ne produisent pas le moindre fichier objet. lis ne peuvent contenir que des 
declarations qui permettent a diverses unites de compilation de communiquer entre elles. II ne 
serait done pas approprie d'introduire 1' implementation de la fonction square ( ) dans un tel 
fichier. Si nous l'avions fait dans cet exemple, cela n'aurait declenche aucune erreur, parce que 
nous incluons square. h une seule fois, mais si nous avions inclus square. h dans plusieurs 
fichiers .cpp, nous aurions obtenu de multiples implementations de square ( ) (une par fichier 
.cpp dans lequel elle est incluse). L'editeur signalerait alors la presence de definitions multi- 
ples (identiques) de square () et refuserait de generer l'executable. Inversement, si nous 
declarons une fonction mais que nous oublions de 1' implemented l'editeur de liens signale un 
"symbole non resolu". 

Jusqu'a present, nous avons suppose qu'un executable etait uniquement constitue de fichiers 
objet. En pratique, ils comportent aussi souvent des liaisons vers des bibliotheques qui imple- 
mentent une fonctionnalite prete a Tempi oi. II existe deux principaux types de bibliotheque : 

• Les bibliotheques statiques qui sont directement inserees dans l'executable, comme s'il 
s'agissait de fichiers objet. Cela annule les risques de perte de la bibliotheque mais cela 
augmente la taille de l'executable. 

• Les bibliotheques dynamiques (egalement nominees bibliotheques partagees ou DLL) qui 
sont stockees sur un emplacement standard sur l'ordinateur de l'utilisateur et qui sont auto- 
matiquement chargees au demarrage de 1' application. 

Pour le programme square, nous etablissons une liaison avec la bibliotheque C++ standard, 
qui est implementee en tant que bibliotheque dynamique sur la plupart des plates-formes. Qt 
lui-meme est une collection de bibliotheques qui peuvent etre generees en tant que bibliotheques 
statiques ou dynamiques (dynamique est 1' option par defaut). 
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Principales differences de langage 

Nous allons maintenant examiner de pres les domaines dans lesquels C++ differe de Java et 
C#. De nombreuses differences de langage sont dues a la nature compilee du C++ et a ses obli- 
gations en termes de performances. Ainsi, le C++ ne controle pas les limites de tableau au 
moment de l'execution, et aucun programme de recuperation de la memoire ne reaffecte la 
memoire allouee dynamiquement apres usage. 

Pour rester concis, nous n'aborderons pas dans cette annexe les constructions C++ qui sont 
pratiquement identiques a leurs equivalents Java et C#. Certains sujets C++ ne sont pas non 
plus couverts ici parce qu'ils ne sont pas indispensables pour la programmation avec Qt. Nous 
ne traitons pas, en particulier, la definition des fonctions et classes modeles, celle des types 
union, et les exceptions. Vous trouverez une description detaillee de l'ensemble des fonction- 
nalites du langage dans un ouvrage tel que Le langage C+ + de Bjarne Stroustrup ou C+ + pour 
les programmeurs Java de Mark Allen Weiss. 



Les types de donnees primitifs 

Les types de donnees primitifs du C++ sont analogues a ceux de Java ou C#. La Figure B.2 
repertorie ces types avec leur definition sur les plates-formes prises en charge par Qt 4. 



Type C+ + 


Description 


bool 


Valeur booleenne 


char 


Entier 8 bits 


short 


Entier 16 bits 


int 


Entier 32 bits 


long 


Entier 32 bits ou 64 bits 


long long_ 


Entier 64 bits 


float 


Valeur virgule flottante 32 bits (IEEE 754) 


double 


Valeur virgule flottante 64 bits (IEEE 754) 



Figure B.2 

Les types primitifs de C+ + 



Par defaut, les types short, int, long, et long long sont signes, ce qui signifie qu'ils 
peuvent stocker aussi bien des valeurs negatives que des valeurs positives. Si nous n'avons 
besoin de stocker que des nombres positifs, nous pouvons coder le mot-cle unsigned devant le 
type. Alors qu'un short est capable de stocker n'importe quelle valeur entre -32 768 et 
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+32 767, un unsigned short stocke une valeur entre 0 et 65 535. Loperateur de decalage a 
droite » ("remplit avec des 0") a une semantique non signee si un des operandes est non 
signe. Le type bool peut avoir les valeurs true et false. De plus, les types numeriques 
peuvent etre utilises partout ou un bool est attendu, 0 etant interprets comme false et toute 
valeur non nulle par true. 

Le type char sert a la fois pour le stockage des caracteres ASCII et pour celui des entiers 8 bits 
(octets). Lorsqu'il est utilise pour un entier, celui-ci peut etre signe ou non signe, selon la plate- 
forme. Les types signed char et unsigned char sont des alternatives non ambigiies au 
char. Qt fournit un type QChar qui stocke des caracteres Unicode 16 bits. 

Les instances des types integres ne sont pas initialisers par defaut. Lorsque nous creons une 
variable int, sa valeur pourrait tout aussi bien etre de 0 que de -209 486 515. Heureusement, 
les compilateurs nous avertissent pour la plupart lorsque nous tentons de lire le contenu d'une 
variable non initialisee. Nous pouvons faire appel a des outils tels que Rational PurifyPlus et 
Valgrind pour detecter les acces a de la memoire non initialisee et les autres problemes lies a la 
memoire lors de l'execution. 

En memoire, les types numeriques (a l'exception des long) ont des tailles identiques sur les 
differentes plates-formes prises en charge par Qt, mais leur representation varie selon 1' archi- 
tecture du systeme. Sur les architectures big-endian (telles que PowerPC et SPARC), la valeur 
32 bits 0x1 2345678 est stockee sous la forme des quatre octets 0x1 2 0x34 0x56 0x78, alors 
que sur les architectures little-endian (telles que Intel x86), la sequence d'octets est inversee. 
La difference apparait dans les programmes qui copient des zones de memoire sur disque ou 
qui envoient des donnees binaires sur le reseau. La classe QDataStream de Qt, presentee au 
Chapitre 12 (Entrees/Sorties), peut etre utilisee pour stacker des donnees binaires en restant 
independant de la plate-forme. 

Chez Microsoft, le type long long s'appelle int64. Dans les programmes Qt, qlonglong 

est propose comme une alternative compatible avec toutes les plates-formes de Qt. 

Definitions de classe 

Les definitions de classe en C++ sont analogues a celles de Java et C#, mais vous devez 
connaitre plusieurs differences. Nous allons les etudier avec une serie d'exemples. 
Commencons par une classe qui represente une paire de coordonnees (x, y) : 

#ifndef P0INT2D_H 
#define P0INT2D_H 

class Point2D 
{ 

Public 

Point2D() { 
xVal = 0; 
yVal = 0; 

} 
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Point2D(double x, double y) { 
xVal = x; 
yVal = y; 

} 

void setXfdouble x) { xVal = x; } 
void setYfdouble y) { yVal = y; } 
double x() const { return xVal; } 
double y() const { return yVal; } 

Private 

double xVal; 
double yVal; 

}; 

#endif 

La definition de classe precedente devrait apparaitre dans un fichier d'en-tete, typiquement 
nomine point2d . h. Cet exemple illustre les caracteristiques C++ suivantes : 

• Une definition de classe est divisee en sections publique, protegee et privee, et se termine 
par un point- virgule. Si aucune section n'est specifiee, la section par defaut est privee. 
(Pour des raisons de compatibilite avec le C, C++ fournit le mot-cle struct identique a 
class sauf que la section par defaut est publique si aucune section n'est specifiee.) 

• La classe comporte deux constructeurs (le premier sans parametre et le second avec deux 
parametres). Si nous n'avions pas declare de constructeur, C++ en aurait automatiquement 
fourni un sans parametre avec un corps vide. 

• Les fonctions d'acces x ( ) et y ( ) sont declarees comme const. Cela signifie qu'elles ne 
peuvent ni modifier les variables membres ni appeler des fonctions membres non-const 
(telles que setX( ) etsetY()). 

Les fonctions ci-dessus ont ete implementees inline, dans la definition de classe. Vous avez 
aussi la possibility de ne fournir que les prototypes de fonction dans le fichier d'en-tete et 
d'implementer les fonctions dans un fichier .cpp. Dans ce cas, le fichier d'en-tete aurait la 
syntaxe suivante : 

#ifndef P0INT2D_H 
#define P0INT2D_H 

class Point2D 
{ 

Public 

Point2D() ; 

Point2D(double x, double y); 

void setXfdouble x) ; 
void setYfdouble y) ; 
double x() const; 
double y() const; 



492 Qt4 et C++ : Programmation d'interfaces GUI 



Private 

double xVal; 
double yVal; 

}; 

#endif 

Les fonctions seraient alors implementees dans point2d . cpp : 

#include "point2d.h" 

Point2D: :Point2D() 

xVal =0.0; 
yVal =0.0; 

Point2D: :Point2D(double x, double y) 

xVal = x; 
yVal = y; 

void Point2D: :setX(double x) 
xVal = x; 

void Point2D: :setY(double y) 
yVal = y; 

double Point2D::x() const 
return xVal; 

double Point2D::y() const 
return yVal; 

Nous commencons par inclure point2d . h parce que le compilateur a besoin de la definition 
de classe pour etre en mesure d' analyser les implementations de fonction membre. Nous 
implementons ensuite les fonctions, en prefixant leurs noms de celui de la classe suivi de 
P operate ur : : . 

Nous avons deja explique comment implementer une fonction inline et maintenant comment 
Pimplementer dans un fichier .cpp. Les deux methodes sont equivalentes d'un point de vue 
semantique, mais lorsque nous appelons une fonction qui est declaree inline, la plupart des 



Annexe B 



Introduction au langage C++ pour les programmeurs Java et C# 493 



compilateurs se contentent d'inserer le corps de la fonction plutot que de generer un veritable 
appel de fonction. Vous obtenez generalement un code plus performant, mais la taille de 
l'application est superieure. C'est pourquoi seules les fonctions tres courtes devraient etre 
implementees de cette facon ; les autres devront plutot etre implementees dans un fichier . cpp. 
De plus, si nous oublions d'implementer une fonction et que nous tentons de l'appeler, 
l'editeur de liens va signaler un symbole non resolu. 

Essayons maintenant d'utiliser la classe. 
#include "point2d.h" 

int main() 
{ 

Point2D alpha; 

Point2D beta(0.666, 0.875); 

alpha. setX(beta.yO) ; 
beta.setY(alpha.x()) ; 

return 0; 

} 

En C++, les variables de tout type peuvent etre declarees directement sans coder new. La 
premiere variable est initialisee a l'aide du constructeur par defaut Point 2D (celui qui ne recoit 
aucun parametre). La seconde variable est initialisee a l'aide du second constructeur. L'acces 
au membre de l'objet s'effectue via l'operateur "." (point). 

Les variables declarees de cette facon se comportent comme les types primitifs de Java/C# tels 
que int et double. Lorsque nous codons l'operateur d' affectation, par exemple, c'est le 
contenu de la variable qui est copie et non une simple reference a l'objet. Si nous modifions 
une variable par la suite, cette modification ne sera pas repercutee dans les variables a qui on a 
pu affecter la valeur de la premiere. 

En tant que langage oriente objet, C++ prend en charge l'heritage et le polymorphisme. Nous 
allons etudier ces deux proprietes avec l'exemple de classe de base abstraite Shape et une 
sous-classe nominee Circle. Commencons par la classe de base : 

#ifndef SHAPEJH 
#define SHAPEJH 

#include "point2d.h" 

class Shape 
{ 

Public 

Shape(Point2D center) { myCenter = center; } 
virtual void draw() = 0; 
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Protected 

Point2D myCenter; 

}; 

#endif 

La definition se trouve dans un fichier d'en-tete nomme shape . h. Cette definition faisant refe- 
rence a la classe Point2D, nous incluons point2d . h. 

La classe Shape ne possede pas de classe de base. Contrairement a Java et C#, C++ ne fournit 
pas de classe Object generique a partir de laquelle toutes les classes heritent. Qt fournit 
QOb j ect comme classe de base naturelle pour toutes sortes d'objets. 

La declaration de la fonction draw( ) presente deux caracteristiques interessantes : elle comporte 
le mot-cle virtual, et elle se termine par = 0. Ce mot-cle signale que la fonction pourrait etre 
reimplementee dans les sous-classes. Comme en C#, les fonctions membres C++ ne sont pas reim- 
plementables par defaut. La syntaxe bizarre =0 indique que la fonction est une fonction 
virtuelle pure, c'est-a-dire une fonction qui ne possede aucune implementation par defaut et qui 
doit obligatoirement etre implemented dans les sous-classes. Le concept "d'interface" en Java 
et C# correspond a une classe constituee uniquement de fonctions virtuelles pures en C++. 

Voici la definition de la sous-classe Circle : 

#ifndef CIRCLE_H 
#define CIRCLE_H 

#include "shape. h" 

class Circle : public Shape 
{ 

Public 

Circle(Point2D center, double radius = 0.5) 
: Shape(center) { 
myRadius = radius; 

} 

void draw() { 

//executer ici une action 

} 

Private 

double myRadius; 

}; 

#endif 

La classe Circle herite publiquement de Shape, ce qui signifie que tous les membres publics 
de cette derniere restent publics dans Circle. C++ prend aussi en charge l'heritage prive et 
protege, qui limite l'acces aux membres publics et proteges de la classe de base. 

Le constructeur recoit deux parametres : le second est facultatif et il prend la valeur 0.5 
lorsqu'il n'est pas specifie. Le constructeur transmet le parametre correspondant au centre au 
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constracteur de la classe de base en appliquant une syntaxe particuliere entre la signature et le 
corps de la fonction. Dans le corps, nous initialisons la variable membre myRadius. Nous 
aurions pu aussi grouper 1' initialisation de la variable avec celle du constructeur de la classe de 
base sur la meme ligne : 

Circle(Point2D center, double radius = 0.5) 
: Shape(center) , myRadius (radius) { } 

D'autre part, C++ n'autorise pas l'initialisation d'une variable membre dans la definition de 
classe, le code suivant est done incorrect : 

// ne compilera pas 
Private 

double myRadius = 0.5; 

}; 

La fonction draw( ) possede la meme signature que la fonction virtuelle draw( ) declaree dans 
Shape. II s'agit d'une reimplementation et elle sera invoquee de facon polymorphique au 
moment ou draw( ) sera appelee pour une instance de Circle par le biais d'un pointeur ou 
d'une reference de Shape. C++ ne fournit pas de mot-cle pour une redefinition de fonction 
comme en C#. Ce langage ne comporte pas non plus de mot-cle super ou base qui fasse refe- 
rence a la classe de base. Si nous avons besoin d'appeler 1' implementation de base d'une 
fonction, nous pouvons prefixer son nom avec celui de la classe de base suivi de l'operateur : : . 
Par exemple : 

class LabeledCircle : public Circle 
{ 

Public 

void draw() { 
Circle: :draw() ; 
drawLabel( ) ; 

} 

}; 

C++ prend en charge l'heritage multiple, ce qui signifie qu'une classe peut etre derivee de 
plusieurs classes a la fois. Voici la syntaxe : 

class DerivedClass : public BaseClassI , public BaseClass2, 
public BaseClassN 

{ 

}; 

Par defaut, fonctions et variables declarees dans une classe sont associees avec les instances de 
cette classe. Nous avons aussi la possibilite de declarer des fonctions membres et des variables 
membres statiques, que vous utilisez ensuite sans instance. 
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Par exemple : 

#ifndef TRUCK_H 
#define TRUCK_H 

class Truck 
{ 

Public 

Truck() { ++counter; } 
-Truck() { --counter; } 

static int instanceCount() { return counter; } 

Private 

static int counter; 

}; 

#endif 

La variable membre statique counter assure le suivi du nombre d' instances de Truck a un instant 
donne. C'est le constructeur de Truck qui l'incremente. Le destructeur, que vous reconnaissez 
au prefixe ~, decremente cette valeur. En C++, le destructeur est automatiquement invoque 
lorsqu'une variable allouee de facon statique sort de la portee ou lorsqu'une variable allouee 
avec new est supprimee. Ce comportement est analogue a celui de la methode finalize ( ) en 
Java, sauf que nous pouvons l'obtenir en y faisant appel a un instant specifique. 

Une variable membre statique existe uniquement dans sa classe : il s'agit de "variables de 
classe" plutot que de "variables d'instance". Chaque variable membre statique doit etre definie 
dans un fichier . cpp (mais sans repeter le mot-cle static). Par exemple : 

#include "truck. h" 

int Truck: :counter = 0; 

Si vous ne suivez pas cette regie, vous obtiendrez une erreur de "symbole non resolu" au 
moment de l'edition des liens. La fonction statique instanceCount ( ) est accessible depuis 
l'exterieur de la classe, en la prefixant avec le nom de cette derniere. Par exemple : 

#include <iostream> 

#include "truck. h" 

using namespace std; 

int main() 
{ 

Truck truckl ; 
Truck truck2; 

cout « Truck: : instanceCount () « " equals 2" « endl; 
return 0; 

} 
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Les pointeurs 

Un pointeur en C++ est une variable qui stocke l'adresse memoire d'un objet (plutot que 
l'objet lui-meme). Java et C# ont un concept analogue, la "reference," mais avec une syntaxe 
differente. Nous allons commencer par etudier un exemple (peu realiste) pour observer les 
pointeurs en action : 

1 #include "point2d.h" 

2 int main() 



3 


{ 


4 


Point2D alpha; 


5 


Point2D beta; 


6 


Point2D *ptr; 


7 


ptr = α 


8 


ptr->setX(1 .0); 


9 


ptr->setY(2.5); 


0 


ptr = β 


1 


ptr->setX(4.0) ; 


2 


ptr->setY(4.5) ; 


3 


ptr = 0; 


4 


return 0; 


5 


} 



Cet exemple s'appuie sur la classe Point2D de la sous-section precedente. Les lignes 4 et 5 
definissent deux objets de type Point2D. Ces objets sont initialises a (0, 0) par le constructeur 
de Point2D par defaut. 

La ligne 6 definit un pointeur vers un objet Point2D. La syntaxe des pointeurs place un asteris- 
que devant le nom de la variable. Ce pointeur n'ayant pas ete initialise, il contient une adresse 
memoire aleatoire. Ce probleme est regie ligne 7 par l'affectation de l'adresse d'alpha a ce 
pointeur. L'operateur unaire & renvoie l'adresse memoire d'un objet. Une adresse est typi- 
quement une valeur entiere sur 32 ou 64 bits qui specifie le decalage d'un objet en memoire. 

En lignes 8 et 9, nous accedons a l'objet alpha via le pointeur ptr. ptr etant un pointeur et 
non un objet, nous devons coder l'operateur -> (fleche) plutot que l'operateur . (point). 

Ligne 10, nous affectons l'adresse de beta au pointeur. A partir de la, toute operation sur le 
pointeur va affecter l'objet beta. 

Ligne 13, le pointeur est defini en pointeur nul. C++ ne fournit pas de mot-cle pour representer 
un pointeur qui ne pointe pas vers un objet; c'est pourquoi nous affectons la valeur 0 (ou la 
constante symbolique NULL, qui represente 0). Lemploi d'un pointeur nul entraine aussitot 
une panne accompagnee d'un message d'erreur du type "Erreur de segmentation", "Erreur de 
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protection generale", ou "Erreur de bus". Avec l'aide d'un debogueur, nous pouvons retrouver 
la ligne de code a l'origine de 1' erreur. 

A la fin de la fonction, l'objet alpha contient la paire de coordonnees (1.0, 2.5), alors que 
beta contient (4.0, 4.5). 

Les pointeurs sont souvent employes pour stacker des objets alloues dynamiquement a l'aide 
de new. En jargon C++, nous disons que ces objets sont alloues sur le "tas", alors que les variables 
locales (les variables definies dans une fonction) sont stockees sur la "pile". 

Voici un extrait de code qui illustre l'allocation de memoire dynamique a l'aide de new : 

#include "point2d.h" 

int main() 

{ 

Point2D *point = new Point2D; 
point->setX(1 .0) ; 
point->setY(2.5) ; 
delete point; 

return 0; 

} 

L'operateur new renvoie l'adresse memoire de l'objet qui vient d'etre alloue. Nous stockons 
l'adresse dans une variable pointeur et l'acces a l'objet s'effectue via le pointeur. Quand nous 
en avons termine avec l'objet, nous liberons la memoire associee a l'aide de l'operateur 
delete. Contrairement a Java et C#, C++ ne possede pas de programme de liberation de la 
memoire (garbage collector) ; les objets alloues dynamiquement doivent etre explicitement 
liberes a l'aide de delete quand nous n'en n'avons plus besoin. Le Chapitre 2 decrit le 
mecanisme parent-enfant de Qt, qui simplifie largement la gestion de memoire dans les 
programmes C++. 

Si nous oublions d'appeler delete, la memoire reste occupee jusqu'a ce que le programme se 
termine. Cela ne poserait aucun probleme dans l'exemple precedent, parce que nous n'allouons 
qu'un seul objet, mais dans le cas d'un programme qui allouerait constamment de nouveaux 
objets, les allocations de memoire associees se produiraient jusqu' a saturation de la memoire 
de l'ordinateur. Une fois qu'un objet est supprime, la variable pointeur contient toujours 
l'adresse de cet objet. Ce pointeur devient un "pointeur dans le vide" et ne doit plus etre utilise. 
Qt fournit un pointeur "intelligent," QPointer<T>, qui se definit automatiquement a 0 si le 
QOb j ect sur lequel il pointe est supprime. 

Dans l'exemple ci-dessus, nous avons invoque le constructeur par defaut et nous avons appele 
setX( ) et setY( ) pour initialiser l'objet. Nous aurions pu faire plutot appel au constructeur a 
deux parametres :q 

Point2D *point = new Point2D(1.0, 2.5); 
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L'exemple n'exigeait pas l'emploi de new et de delete. Nous aurions tres bien pu allouer 
l'objet sur la pile de la facon suivante : 

Point2D point; 
point. setX(1 .0) ; 
point.setY(2.5) ; 

La memoire occupee par des objets alloues de cette facon est automatiquement recuperee a la 
fin du bloc dans lequel ils apparaissent. 

Si nous n'avons pas l'intention de modifier l'objet par l'intermediaire du pointeur, nous 
pouvons declarer le pointeur const. Par exemple : 

const Point2D *ptr = new Point2D(1.0, 2.5); 
double x = ptr->x() ; 
double y = ptr->y ( ) ; 

// la compilation va echouer 

ptr->setX(4.0) ; 

*ptr = Point2D(4.0, 4.5); 

Le pointeur ptr const sert uniquement a appeler des fonctions membres const telles que 
x() et y(). Prenez 1' habitude de declarer vos pointeurs comme const quand vous ne 
prevoyez pas de modifier l'objet par leur intermediate. De plus, si l'objet lui-meme est const, 
nous n'avons de toute facon pas d' autre choix que d'utiliser un pointeur const pour stocker 
son adresse. Le mot-cle const apporte des informations au compilateur qui est ainsi en mesure 
de detecter tres tot des erreurs et d'ameliorer les performances. C# comporte un mot-cle const 
tres similaire a celui de C++. L' equivalent Java le plus proche est final, mais il protege les 
variables uniquement contre les affectations, pas contre les appels de fonctions membres "non- 
const" sur ces dernieres. 

Les pointeurs fonctionnent avec les types integres ainsi qu'avec les classes. Dans une expression, 
l'operateur unaire * renvoie la valeur de l'objet associe au pointeur. Par exemple : 

int i = 10; 
int j = 20; 

int *p = &i; 
int *q = &j ; 

cout « *p « " equals 10" « endl; 
cout « *q « " equals 20" « endl; 

*p = 40; 

cout « i « " equals 40" « endl; 

p = q; 

*p = 100; 

cout « i « " equals 40" « endl; 
cout « j « " equals 100" « endl; 
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L'operateur ->, a partir duquel vous avez acces aux membres d'un objet via un pointeur, a une 
syntaxe tres particuliere. Plutot que de coder ptr->membre, nous pouvons aussi ecrire 
( *ptr ) . membre. Les parentheses sont necessaires parce que l'operateur " . " (point) est priori- 
taire sur l'operateur unaire *. 

Les pointeurs avaient mauvaise reputation en C et C++, a tel point que la promotion de Java 
insiste souvent sur 1' absence de pointeur dans ce langage. En realite, les pointeurs C++ sont 
analogues d'un point de vue conceptuel aux references de Java et C# sauf que nous pouvons 
nous servir de pointeurs pour parcourir la memoire, comme vous le decouvrirez un peu plus 
loin dans cette section. De plus, l'inclusion des classes conteneur en "copie a l'ecriture" dans 
Qt, ainsi que la possibilite de C++ d'instancier une classe sur la pile, signirie que nous pouvons 
souvent eviter d' avoir recours aux pointeurs. 

Les references 

En complement des pointeurs, C++ prend aussi en charge le concept de "reference". Comme un 
pointeur, une reference C++ stocke l'adresse d'un objet. Voici les principales differences : 

• Les references sont declarees a l'aide de & plutot que *. 

• Les references doivent etre initialisers et ne peuvent etre reaffectees par la suite. 

• L' objet associe a une reference est directement accessible ; il n'y a pas de syntaxe parti- 
culiere telle que * ou ->. 

• Une reference ne peut etre nulle. 

Les references sont surtout utilisees pour declarer des parametres. Par defaut, C++ applique le 
mecanisme de transmission par valeur lors de la transmission des parametres, ce qui signifie 
que lorsqu'un argument est transmis a une fonction, celle-ci regoit une copie entierement 
nouvelle de l'objet. Voici la definition d'une fonction qui regoit ses parametres par le biais d'un 
appel par valeur : 

#include <cstdlib> 
using namespace std; 

double manhattanDistance(Point2D a, Point2D b) 
{ 

return abs(b.x() - a.x()) + abs(b.y() - a.y()); 

} 

Nous pourrions alors invoquer la fonction comme suit : 

Point2D broadway(12.5, 40.0); 
Point2D harlem(77.5, 50.0); 

double distance = manhattanDistancefbroadway, harlem); 
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Les programmeurs C convertis evitent les operations de copie inutiles en declarant leurs para- 
metres sous forme de pointeurs plutot que sous forme de valeurs : 

double manhattanDistance (const Point2D *ap, const Point2D *bp) 
{ 

return abs(bp->x() - ap->x()) + abs(bp->y() - ap->y()); 

} 

lis doivent ensuite transmettre les adresses plutot que les valeurs lors de l'appel de la fonction : 

Point2D broadway(12.5, 40.0); 
Point2D harlem(77.5, 50.0); 

double distance = manhattanDistance (Sbroadway, &harlem); 

C++ a introduit les references arm de simplifier la syntaxe et d'eviter que l'appelant ne trans- 
mette un pointeur nul. Si nous utilisons des references plutot que des pointeurs, voici ce que 
devient la fonction : 

double manhattanDistancefconst Point2D &a, const Point2D &b) 
{ 

return abs(b.x() - a.x()) + abs(b.y() - a.y()); 

} 

La declaration d'une reference est analogue a celle d'un pointeur, & remplacant *. Mais lors- 
que nous utilisons effectivement la reference, nous pouvons oublier qu'il s'agit d'une adresse 
memoire et la traiter comme une variable ordinaire. De plus, l'appel d'une fonction qui recoit 
des references en arguments n'exige aucune attention particuliere (pas d'operateur &). 

Dans l'ensemble, en remplacant Point2D par const Point2D & dans la liste de parametres, 
nous avons reduit la surcharge de traitement de l'appel de fonction : plutot que de copier 
256 bits (la taille de quatre double), nous copions seulement 64 ou 128 bits, selon la taille du 
pointeur de la plate-forme cible. 

L'exemple precedent s'appuyait sur les references const, ce qui empechait la fonction de 
modifier les objets associes aux references. Lorsqu'on veut au contraire autoriser ce comportement, 
nous pouvons transmettre une reference ou un pointeur non-const. Par exemple : 

void transpose(Point2D &point) 
{ 

double oldX = point. x() ; 
point. setX(point.y() ) ; 
point. setY(oldX) ; 

} 

Dans certains cas, nous disposons d'une reference et nous avons besoin d'appeler une fonction 
qui recoit un pointeur, ou vice versa. Pour convertir une reference en pointeur, nous pouvons 
tout simplement utiliser 1' operate ur unaire & : 

Point2D point; 
Point2D &ref = point; 
Point2D *ptr = &ref; 
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Pour convertir un pointeur en reference, il y a l'operateur unaire * : 

Point2D point; 
Point2D *ptr = &point; 
Point2D &ref = *ptr; 

References et pointeurs sont represented de la meme facon en memoire, et ils peuvent souvent 
etre utilises de facon interchangeable, ce qui souleve la question de quel element a utiliser et 
quand. D'un cote, la syntaxe des references est plus pratique. D'un autre cote, a tout moment 
vous pouvez reaffecter les pointeurs pour pointer sur un autre objet, ils peuvent stacker une 
valeur nulle, et leur syntaxe plus explicite est plutat une bonne chose. C'est pour cette raison 
que les pointeurs ont tendance a l'emporter, les references etant plutat presque exclusivement 
employee pour declarer les parametres de fonction, en conjonction avec const. 



Les tableaux 

Les tableaux en C++ sont declares en specifiant leur nombre d'elements entre crochets dans la 
declaration de variable apres le nom de variable. II est possible de creer des tableaux a deux 
dimensions a l'aide d'un tableau de tableau. Voici la definition d'un tableau a une dimension 
contenant 10 elements de type int : 

int f ibonacci[10] ; 

On accede aux elements via la syntaxe f ibonacci[0], f ibonacci[ 1 ], f ibonacci[9]. 
Nous avons souvent besoin d'initialiser le tableau lors de sa definition : 

int f ibonacci[10] = { 0, 1 , 1 , 2, 3, 5, 8, 13, 21, 34 }; 

Dans ce cas, nous pouvons alors omettre la taille de tableau puisque le compilateur peut la 
deduire a partir du nombre d'initialisations : 

int fibonacci[] = { 0, 1 , 1 , 2, 3, 5, 8, 13, 21, 34 }; 

L' initialisation statique fonctionne aussi pour les types complexes, tels que Point2D : 

Point2D triangle[] = { 

Point2D(0.0, 0.0), Point2D(1.0, 0.0), Point2D(0.5, 0.866) 

}; 

Si nous n'avons pas l'intention de modifier le tableau par la suite, nous pouvons le rendre const : 

const int fibonacci[] = { 0, 1 , 1 , 2, 3, 5, 8, 13, 21, 34 }; 

Pour trouver le nombre d'elements d'un tableau, il suffit d'executer l'operateur sizeof () 
comme suit : 

int n = sizeof (fibonacci) / sizeof (f ibonacci[0] ) ; 
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Cet operateur renvoie la taille de ses arguments en octets. Le nombre d' elements dans un 
tableau correspond a la taille de ce dernier en octets divisee par la taille d'un de ses elements. 
Comme c'est un peu fatiguant a taper, une solution courante consiste a declarer une constante 
et a l'utiliser pour definir le tableau : 

enum { NFibonacci = 10 }; 

const int f ibonacci[NFibonacci] ={0, 1,1,2,3,5,8, 13, 21, 34 }; 

II aurait ete tentant de declarer la constante sous forme de variable const int. 

Malheureusement, certains compilateurs acceptent mal les variables const pour specifier les 
tailles de tableau. Le mot-cle enum sera explique plus tard dans cette annexe. Le parcours d'un 
tableau est normalement realise a l'aide d'un entier. Par exemple : 

for (int i = 0; i < NFibonacci; ++i) 
cout « fibonacci[i] « endl; 

II est aussi possible de parcourir le tableau a l'aide d'un pointeur : 

const int *ptr = &f ibonacci[0] ; 
while (ptr != &fibonacci[10] ) { 

cout « *ptr « endl; 

++ptr; 

} 

Nous initialisons le pointeur avec l'adresse du premier element et nous bouclons jusqu'a ce 
que nous atteignons l'element "qui suit le dernier" (le "onzieme" element, fibonacci[10]). 
A chaque iteration, l'operateur ++ positionne le pointeur sur l'element suivant. 

Au lieu de &f ibonacci[0], nous aurions aussi pu ecrire fibonacci. En effet, le nom d'un 
tableau utilise seul est automatiquement converti en pointeur vers le premier element du 
tableau. De la meme facon, nous pourrions remplacer fibonacci + 10 par &fibo- 
nacci[10]. Cela marche aussi en sens inverse: nous pouvons recuperer le contenu de 
l'element courant en codant soit *ptr soit ptr[0] et nous pourrions acceder a l'element suivant 
a l'aide de * (ptr + 1) ouptr[1]. 

On fait quelquefois reference a ce principe en termes "d'equivalence entre pointeurs et tableaux". 

Pour empecher ce qu'il considere comme une perte d'efficacite gratuite, C++ nous interdit de 
transmettre des tableaux a des fonctions par valeur. II faut plutot transmettre leur adresse. 
Par exemple : 

#include <iostream> 

using namespace std; 

void printIntegerTable(const int "table, int size) 
{ 

for (int i = 0; i < size; ++i) 
cout « table[i] « endl; 

} 
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int main() 
{ 

const int f ibonacci[10] = { 0, 1 , 1 , 2, 3, 5, 8, 13, 21, 34 }; 
printIntegerTable(f ibonacci, 10) ; 
return 0; 

} 

Ironiquement, alors que le C++ ne nous donne aucun choix concernant le mode de transmis- 
sion d'un tableau, par adresse ou par valeur, il nous accorde quelques libertes dans la syntaxe 
employee pour declarer le type de parametre. Pour remplacer const int *table, nous 
aurions pu coder const int table [ ] pour declarer un parametre pointeur-vers-constante- 
int. D'une facon analogue, le parametre argv de main ( ) peut etre declare soit en tant que 
char *argv[ ] soit en tant que char **argv. 

Pour copier un tableau dans un autre tableau, une solution consiste a boucler dans le tableau : 

const int f ibonacci[NFibonacci] = { 0, 1 , 1 , 2, 3, 5, 8, 13, 21, 34 }; 
int temp[NFibonacci] ; 

for (int i = 0; i < NFibonacci; ++i) 
temp[i] = f ibonacci[i] ; 

Pour les types de base tel que int, nous pouvons aussi utiliser std : : memcpy ( ) , qui copie un 
bloc de memoire. Par exemple : 

memcpy (temp, fibonacci, sizeof (fibonacci) ) ; 

Lorsque nous declarons un tableau C++, la taille doit etre une constante.Si nous desirons creer 
un tableau de taille variable, nous avons plusieurs solutions. 

• Nous pouvons allouer dynamiquement ce tableau : 

int *fibonacci = new int[n]; 

Certains compilateurs autorisent les variables dans ce contexte, mais il ne faut pas exploiter ce 
type de fonctionnalite pour creer un programme portable. 

L'operateur new[] alloue un certain nombre d' elements dans des emplacements memoire 
consecutifs et renvoie un pointeur vers le premier element. Grace au principe de "1' equivalence 
des pointeurs et des tableaux," on peut acceder aux elements par 1' intermediate d'un pointeur 
avec f ibonacci[0] , f ibonacci[ 1 ], fibonacci[n -1 ]. Des que le tableau n'est plus 
necessaire, nous devons liberer la memoire qu'il occupe en executant l'operateur delete [ ] : 

delete [] fibonacci; 

• Nous pouvons appliquer la syntaxe standard std : : vector<T> class : 
#include <vector> 

using namespace std; 
vector<int> f ibonacci(n) ; 
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Vous accedez aux elements a l'aide de l'operateur [ ], exactement comme dans un tableau 
C++ ordinaire. Avec std: :vector<T> (ou T est le type des elements stockes dans le 
vecteur), nous pouvons redimensionner le tableau a tout moment en executant resize ( ) et 
nous le copions avec l'operateur d' affectation. Les classes qui contiennent des crochets 
(<>) dans leur nom sont appelees classes modele. 

• Nous pouvons utiliser la syntaxe QVector<T> class de Qt : 

#include <QVector> 

QVector<int> f ibonacci(n) ; 

L' API de QVector<T> est tres proche de celle de std : : vector<T>, mais elle prend aussi en 
charge l'iteration via le mot-cle f oreach de Qt et elle utilise le partage de donnees ("copie a 
l'ecriture") afin d'optimiser la memoire et les temps de reponse. Le Chapitre 11 presente les 
classes conteneur de Qt et expose leurs relations avec les conteneurs standard du C++. 

Vous pourriez etre tente d'eviter au maximum les tableaux integres et de coder plutot std : : 
vector<T> ou QVector<T>. II est pourtant essentiel de bien comprendre le fonctionnement 
des tableaux integres parce que tot ou tard vous en aurez besoin dans du code fortement opti- 
mise ou pour servir d' interface avec les bibliotheques C existantes. 

Les chaines de caracteres 

La facon la plus simple de representer des chaines de caracteres en C++ consiste a utiliser un 
tableau de caracteres termine par un octet nul ('0'). Les quatre fonctions suivantes illustrent le 
comportement de ce type de chaines : 

void hellol ( ) 
{ 

const char str[ ] = { 

' H ' , 'e' , '1' , '1' , 'o' , 1 1 , V , 'o' , V , '1' , ' d ' , 1 \0' 

}; 

cout « str « endl; 

} 

void hello2() 
{ 

const char str[] = "Hello world!"; 
cout « str « endl; 

} 

void hello3() 
{ 

cout « "Hello world!" « endl; 

} 
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void hello4() 
{ 

const char *str = "Hello world!"; 
cout « str « endl; 

} 

Dans la premiere fonction, nous declarons la chaine en tant que tableau et nous l'initialisons de 
facon basique. Notez le caractere 0 (zero) de fin, qui signale la fin de la chaine. La deuxieme 
fonction comporte une definition de tableau similaire mais nous faisons cette fois appel a un 
litteral chaine pour initialiser le tableau. En C++, les litteraux chaine sont de simples tableaux 
de const char avec un caractere 0 de fin implicite. La troisieme fonction emploie directe- 
ment un litteral chaine, sans lui donner de nom. Une fois traduit en instructions de langage 
machine, ce code est identique a celui des deux fonctions precedentes. 

La quatrieme fonction est un peu differente parce qu'elle cree non seulement un tableau 
(anonyme) mais aussi une variable pointeur appelee str qui stocke l'adresse du premier 
element du tableau. Malgre cela, la semantique de la fonction est identique aux trois fonctions 
precedentes, et un compilateur performant devrait eliminer la variable str superflue. 

Les fonctions qui recoivent des chaines C++ en arguments recoivent generalement un char* 
ou un const char*. Voici un programme court qui illustre l'emploi de chacune d'elles : 

#include <cctype> 
#include <iostream> 

using namespace std; 

void makeUppercasefchar *str) 
{ 

for (int i = 0; str[i] != '\0'; ++i) 
str[i] = toupper(str[i] ) ; 

} 

void writeLine(const char *str) 
{ 

cout « str « endl; 

} 

int mainfint argc, char *argv[]) 
{ 

for (int i = 1; i < argc; ++i) { 
makellppercase(argv[i] ) ; 
writeLine(argv[i] ) ; 
} 

return 0; 

} 

En C++, le type char stocke normalement une valeur 8 bits. Cela signifie que nous pouvons 
facilement stacker des chaines ASCII, ISO 8859-1 (Latin-1), et autres codages 8 bits dans un 
tableau de caracteres, mais que nous ne pouvons pas stacker des caracteres Unicode arbitraires 
sans faire appel a des sequences multioctet. Qt fournit la puissante classe QString, qui stocke 



Annexe B 



Introduction au langage C++ pour les programmeurs Java et C# 507 



des chaines Unicode sous forme de sequences de QChars 16 bits et qui exploite en interne 
1' optimisation du partage de donnees implicite ("copie a l'ecriture"). Cette classe est detaillee 
dans les Chapitres 11 (Classes conteneur) et 17 (Internationalisation). 

Les enumerations 

C++ comprend une fonctionnalite d'enumeration pour la declaration d'un jeu de constantes 
nominees analogue a celle fournie par C#. Supposons que nous voulions stacker les jours de la 
semaine dans un programme : 

enum DayOfWeek { 

Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday 

}; 

Normalement, nous devrions placer cette declaration dans un fichier d'en-tete ou meme dans 
une classe. La declaration precedente est equivalente en apparence aux definitions de constantes 
suivantes : 

const int Sunday = 0; 

const int Monday = 1 ; 

const int Tuesday = 2; 

const int Wednesday = 3; 

const int Thursday = 4; 

const int Friday = 5; 

const int Saturday = 6; 

En exploitant la construction de 1' enumeration, nous pouvons declarer par la suite des variables 
ou parametres de type DayOfWeek et le compilateur garantira que seules les valeurs de 
l'enumeration DayOfWeek leur seront affectees. Par exemple : 

DayOfWeek day = Sunday; 

Si la securite des types ne nous concerne pas, nous pouvons aussi coder 

int day = Sunday; 

Notez que pour faire reference a la constante Sunday dans l'enumeration DayOfWeek, nous 
ecrivons simplement Sunday, et non DayOfWeek : : Sunday. 

Par defaut, le compilateur affecte des valeurs d'entiers consecutifs aux constantes d'une 
enumeration, en commencant a 0. Nous pouvons specifier d'autres valeurs si necessaire : 

enum DayOfWeek { 
Sunday = 628, 
Monday = 616, 
Tuesday = 735, 
Wednesday = 932, 
Thursday = 852, 
Friday = 607, 
Saturday = 845 

}; 
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Si nous ne specifions pas la valeur d'un element de 1'enumeration, celui-ci prend la valeur de 
1' element precedent, plus 1. Les enumerations sont quelquefois employees pour declarer 
des constantes entieres, auquel cas nous omettons normalement le nom de l'enumeration : 

Enum 

FirstPort = 1024, 
MaxPorts = 32767 

}; 

Un autre emploi frequent des enumerations concerne la representation des ensembles 
d'options. Prenons l'exemple d'une boite de dialogue Find, avec quatre cases a cocher contro- 
lant 1'algorithme de recherche (Wildcard syntax, Case sensitive, Search backward, et 
Wrap around). Nous pouvons representer ces cases a l'aide d'une enumeration dans laquelle 
les constantes sont des puissances de 2 : 

enum FindOption { 

NoOptions = 0x00000000, 
WildcardSyntax = 0x00000001 , 
CaseSensitive = 0x00000002, 
SearchBackward = 0x00000004, 
WrapAround = 0x00000008 

}; 

Chaque option est souvent nommee "indicateur". Nous pouvons combiner ces indicateurs a 
l'aide des operateurs bit a bit | ou |= : 

int options = NoOptions; 

if (wilcardSyntaxCheckBox->isChecked ( ) ) 

options |= WildcardSyntax; 
if (caseSensitiveCheckBox->isChecked( ) ) 

options |= CaseSensitive; 
if (searchBackwardCheckBox->isChecked( ) ) 

options |= SearchBackwardSyntax; 
if (wrapAroundCheckBox->isChecked ( ) ) 

options |= WrapAround; 
Nous pouvons tester si un indicateur existe a l'aide de l'operateur & bit a bit: 
if (options & CaseSensitive) { 

// rechercher avec casse significative 

} 

Une variable de type FindOption ne peut contenir qu'un seul indicateur a la fois. La combi- 
naison de plusieurs indicateurs a l'aide de | donne un entier ordinaire. Dans ce cas, les types 
ne sont malheureusement pas securises : le compilateur ne va rien signaler si une fonction qui 
doit recevoir une combinaison de FindOptions dans un parametre int recoit plutot Satur- 
day. Qt utilise QFlags<T> pour securiser les types de ses propres types d'indicateur. La classe 
est egalement disponible lorsque nous derinissons des types d'indicateur personnalises. 
Consultez la documentation en ligne de QFlags<T> pour connaitre tous les details. 
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TypeDef 

Avec C++, nous pouvons definir un alias pour un type de donnees a l'aide du mot-cle 
typedef . Si nous codons souvent par exemple QVector<Point2D> et que nous desirons econo- 
miser les operations de frappe, nous pouvons placer la declaration de typedef suivante dans 
un de nos fichiers d'en-tete : 

typedef QVector<Point2D> PointVector; 

A partir de la, PointVector peut etre code en lieu et place de QVector<Point2D>. Notez que 
le nouveau nom du type apparait apres l'ancien. La syntaxe de typedef suit deliberement 
celle des declarations de variable. 

Avec Qt, les typedef sont surtout employes pour les raisons suivantes : 

• L' aspect pratique : Qt declare uint et QWidgetList en tant que typedef pour unsigned 
int et QList<QWidget *> afin de simplifier la frappe. 

• Les differences entre plates-formes : certains types ont des definitions differentes sur des 

plates-formes differentes. Par exemple, qlonglong est defini comme int64 sous 

Windows et comme long long sur d'autres plates-formes. 

• La compatibilite : la classe QlconSet de Qt 3 a ete renommee en Qlcon dans Qt 4. Pour 
aider les utilisateurs de Qt 3 a porter leurs applications vers Qt4, QlconSet est fourni 
comme typedef pour Qlcon lorsque la compatibilite Qt 3 est activee. 

Conversions de type 

C++ fournit plusieurs syntaxes pour la conversion des valeurs d'un type a 1' autre. La syntaxe 
traditionnelle, heritee de C, implique de placer le type obtenu entre parentheses avant la valeur 
a convertir : 

const double Pi = 3.14159265359; 

int x = (int) (Pi * 100) ; 

cout « x « " equals 314" « endl; 

Cette syntaxe est tres puissante. Elle permet de changer le type des pointeurs, de supprimer 
const, et plus encore. Par exemple : 

short ] = 0x1234; 

if (*(char *)&j == 0x12) 

cout « "The byte order is big-endian" « endl; 

Dans F exemple precedent, nous convertissons un short* en char* et nous utilisons l'operateur 
unaire * pour acceder a 1' octet situe a 1' emplacement de memoire donne. Sur les systemes big- 
endian, cet octet se trouve en 0x1 2 ; sur les systemes little-endian, il se trouve a l'emplacement 
0x34. Les pointeurs et references etant represented de la meme facon, vous ne serez pas surpris 
d'apprendre que le code precedent peut etre reecrit a l'aide d'une conversion de reference : 
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short j = 0x1234; 

if ((char &)j == 0x12) 

cout « "The byte order is big-endian" « endl; 

Si le type de donnees est un nom de classe, un typedef, ou un type primitif qui peut s'exprimer 
sous la forme d'un unique jeton alphanumerique, nous pouvons nous servir de la syntaxe du 
constructeur comme d'une conversion : 

int x = int(Pi * 100) ; 

La conversion des pointeurs et references a l'aide des conversions traditionnelles de style C est 
assez perilleuse parce que le compilateur nous autorise a convertir n'importe quel type de poin- 
teur (ou reference) vers n'importe quel autre type de pointeur (ou reference). C'est pourquoi 
C++ a introduit quatre conversions de style nouveau avec une semantique plus precise. Pour 
les pointeurs et references, les nouvelles conversions sont preferables aux conversions de style 
C plus risquees et sont utilisees dans cet ouvrage. 

• static_cast<T>( ) convertit un pointeur-vers-A en pointeur- vers-B, en imposant que la 
classe B herite de la classe A. Par exemple : 

A *obj = new B; 

B *b = static_cast<B *>(obj); 

b->someFunctionDeclaredInB( ) ; 

Si l'objet n'est pas une instance de B (mais qu'il herite de A), l'usage du pointeur obtenu 
peut produire des pannes obscures. 

• dynamic_cast<T> ( ) est analogue a static_cast<T> ( ), sauf que les informations 
de type a l'execution (RTTI) servent a controler si l'objet associe au pointeur est bien 
une instance de la classe B. Si ce n'est pas le cas, la conversion renvoie un pointeur nul. 
Par exemple : 

A *obj = new B; 

B *b = dynamic_cast<B *> (obj ) ; 
if (b) 

b-> someFunctionDeclaredInB( ) ; 

Avec certains compilateurs, dynamic_cast<T>( ) ne fonctionne pas au-dela des limites de 
la bibliotheque dynamique. Cet element s'appuie egalement sur la prise en charge de RTTI 
par le compilateur, une fonctionnalite que tout bon programmeur doit desactiver pour 
reduire la taille des executables. Qt resout ces problemes en fournissant 
qob j ect_cast<T> ( ) pour les sous-classes de QOb j ect. 

• const_cast<T> ( ) ajoute ou supprime un qualificateur const sur un pointeur ou une refe- 
rence. Par exemple : 

int MyClass: :someConstFunction() const 
{ 

if (isDirtyO) { 

MyClass *that = const_cast<MyClass *>(this); 
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that->recomputeInternalData( ) ; 

} 

} 

Dans l'exemple precedent, nous convertissons le qualificateur const du pointeur this afin 
d'appeler la fonction membre non-const recomputelnternalData ( ). II n'est pas recom- 
mande de proceder de cette facon et vous pouvez l'eviter en codant mutable, comme explique 
au Chapitre 4. 

• reinterpret_cast<T>( ) convertit tout type pointeur ou reference vers un autre type de 
ce genre. Par exemple : 

short j = 0x1234; 

if (reinterpret_cast<char &>(j) == 0x12) 

cout « "The byte order is big-endian" « endl; 

En Java et C#, il est possible de stacker toute reference en tant que reference d'Obj ect. C++ 
ne comporte pas une telle classe de base universelle, mais il fournit un type de donnees parti- 
culier, void*, qui stocke l'adresse d'une instance de n'importe quel type. Un void* doit etre 
reconvertit vers un autre type (a l'aide de static_cast<T> ( )) avant d'etre exploite. 

C++ offre de nombreuses methodes de conversion entre types, mais nous avons rarement 
besoin d'effectuer une conversion dans ce langage. Lorsque nous utilisons des classes conte- 
neurs telles que std : : vector<T> ou QVector<T>, nous specifions le type T et nous recupe- 
rons les elements sans convertir. De plus, pour les types primitifs, certaines conversions 
s'effectuent implicitement (de char vers int par exemple), et pour les types personnalises 
nous pouvons definir des conversions implicites en fournissant un constructeur a un parametre. 
Par exemple : 

class Mylnteger 
{ 

Public 

Mylnteger( ) ; 
Mylnteger(int i) ; 

}; 

int main() 
{ 

Mylnteger n; 
n = 5; 

} 

Pour certains constructeurs a un parametre, la conversion automatique n'est pas justifiee. II est 
possible de la desactiver en declarant le constructeur avec le mot-cle explicit : 

class MyVector 
{ 
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Public 

explicit MyVector(int size); 

}; 

Surcharge d'operateur 

C++ nous permet de surcharger des fonctions, ce qui signifie que nous pouvons declarer 
plusieurs fonctions avec le meme nom dans la meme portee, a partir du moment ou leurs listes 
de parametres sont differentes. C++ prend aussi en charge la surcharge des operateurs. II s'agit 
de la possibility d'affecter une semantique particuliere a des operateurs integres (tels que +, «, 
et [ ]) lorsqu'ils sont employes avec des types personnalises. 

Nous avons deja etudie quelques exemples d'operateurs surcharges. Lorsque nous avions 
utilise « pour transmettre du texte en sortie vers cout ou cerr, nous n'avions pas execute 
l'operateur de decalage de C++, mais plutot une version particuliere de cet operateur qui rece- 
vait un objet ostream (tel que cout et cerr) a gauche et une chaine (ou bien un nombre ou un 
manipulateur de flux tel que endl) a droite et qui renvoyait l'objet ostream, ce qui permettait 
d'effectuer plusieurs appels par ligne. 

L'interet de la surcharge des operateurs est que nous pouvons obtenir un comportement pour 
nos types personnalises identique a celui des types integres. Pour illustrer ce point, nous allons 
surcharger +=,-=,+, et - pour travailler avec des objets Point 2D : 

#ifndef P0INT2D_H 
#define P0INT2D_H 

class Point2D 
{ 

Public 

Point2D() ; 

Point2D(double x, double y); 

void setX(double x) ; 
void setY(double y) ; 
double x() const; 
double y() const; 

Point2D &operator+=(const Point2D &other) { 
xVal += other. xVal; 
yVal += other. yVal; 
return *this; 

} 

Point2D &operator-=(const Point2D &other) { 
xVal -= other. xVal; 
yVal -= other. yVal; 
return *this; 

} 

Private 
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double xVal; 
double yVal; 

}; 

inline Point2D operator+(const Point2D &a, const Point2D &b) 
return Point2D(a.x( ) + b.x(), a.y() + b.y()); 

inline Point2D operator- (const Point2D &a, const Point2D &b) 
return Point2D(a.x( ) - b.x(), a.y() - b.y()); 



#endif 

Les operateurs peuvent etre implemented soit en tant que fonctions membres soit en tant que 
fonctions globales. Dans notre exemple, nous avons implements += et - = en tant que fonctions 
membres, et + et - en tant que fonctions globales. 

Les operateurs += et -= recoivent la reference d'un autre objet Point2D et incrementent ou 
decrementent les coordonneesx ety de 1' objet courant en fonction de 1' autre objet. lis 
renvoient *this, qui represente une reference a l'objet courant (de type Point2D*). Puisqu'on 
renvoie une reference, nous pouvons ecrire du code un peu exotique comme ci-apres : 

a += b += c; 

Les operateurs + et - recoivent deux parametres et renvoient un objet Point 2D par valeur (et 
non la reference d'un objet existant). Grace au mot-cle inline, nous avons la possibility de 
placer ces definitions de fonction dans le fichier d'en-tete. Si le corps de la fonction avait ete 
plus long, nous aurions insere le prototype de fonction dans le fichier d'en-tete et la definition 
de fonction (sans le mot-cle inline) dans le fichier . cpp. 

L'extrait de code suivant presente les quatre operateurs surcharges en action : 

Point2D alpha(12.5, 40.0); 
Point2D beta(77.5, 50.0); 

alpha += beta; 
beta -= alpha; 

Point2D gamma = alpha + beta; 
Point2D delta = beta - alpha; 

Nous invoquons les fonctions operate ur comme n'importe quelle autre fonction : 

Point2D alpha(12.5, 40.0); 
Point2D beta(77.5, 50.0); 

alpha. operator+=(beta) ; 
beta.operator-=(alpha) ; 
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Point2D gamma = operator+(alpha, beta); 
Point2D delta = operator- (beta, alpha); 

La surcharge des operateurs en C++ est un sujet complexe, mais vous n'avez pas forcement 
besoin d'en connaitre tous les details. II est surtout important de comprendre les principes de 
base de la surcharge des operateurs parce que plusieurs classes Qt (notamment QString et 
QVector<T>) s'appuient sur cette fonctionnalite pour fournir une syntaxe plus simple et plus 
naturelle pour des operations telles que la concatenation et l'ajout d'element. 

Les types valeur 

Java et C# differencient les types valeur et les types reference. 

• Types valeur : il s'agit des types primitifs tels que char, int, et float, ainsi que les struc- 
tures C#. lis sont caracterises par le fait qu'ils ne sont pas crees a l'aide de new et que 
l'operateur d' affectation copie la valeur stockee dans la variable. Par exemple : 

int i = 5; 
int j = 10; 
i = i; 

• Types reference : II s'agit de classes telles que Integer (en Java), String, et MaClasse- 
Amoi. Les instances sont creees en codant new. L'operateur d'affectation copie uniquement 
une reference de l'objet ; pour obtenir une copie integrate, il faut appeler clone ( ) (en Java) 
ou Clone ( ) (en C#). Par exemple : 

Integer i = new Integer(5); 
Integer j = new Integer(10); 
i = j . clone () ; 

En C++, tous les types peuvent etre employes en tant que "types reference," et ceux qui 
peuvent etre copies peuvent aussi etre employes en tant que "types valeur". C++n' a pas besoin 
d'un classe Integer, par exemple, parce que vous pouvez vous servir des pointeurs et de new 
comme dans les lignes suivantes : 

int *i = new int(5) ; 
int *j = new int(10) ; 

*i = *j; 

Contrairement a Java et C#, C++ traite les classes definies par l'utilisateur exactement comme 
des types integres : 

Point2D *i = new Point2D(5, 5); 
Point2D *j = new Point2D(10, 10); 

*i = *j; 

Si nous desirons rendre une classe C++ copiable, nous devons prevoir un constructeur de copie 
et un operateur d'affectation pour cette derniere. Le constructeur de copie est invoque lorsque 
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nous initialisons l'objet avec un autre objet de meme type. C++ fournit deux syntaxes equi- 
valentes pour cette situation : 

Point2D i(20, 20); 

Point2D j(i); // premiere syntaxe 

Point2D k = i; // deuxieme syntaxe 

L'operateur d' affectation est invoque lorsque nous utilisons cet operateur sur une variable 
existante : 

Point2D i(5, 5); 
Point2D ](10, 10); 
i = i; 

Lorsque nous definissons une classe, le compilateur C++ fournit automatiquement un 
constructeur de copie et un operateur d' affectation qui effectue une copie membre a membre. 
Pour la classe Point2D, c'est comme si nous avions ecrit le code suivant dans la definition de 
classe : 

class Point2D 
{ 

Public 

Point2D(const Point2D &other) 

: xVal(other.xVal) , yVal(other.yVal) { } 

Point2D &operator=(const Point2D &other) { 
xVal = other. xVal; 
yVal = other. yVal; 
return *this; 

} 

Private 

double xVal; 
double yVal; 

}; 

Pour certaines classes, le constructeur de copie par defaut et l'operateur d'affectation ne 
conviennent pas. Cela se produit en particulier lorsque la classe travaille en memoire dynamique. 
Pour la rendre copiable, nous devons alors implementer nous-memes le constructeur de copie 
et l'operateur d'affectation. 

Pour les classes qui n'ont pas besoin d'etre copiables, nous avons la possibilite de desactiver 
le constructeur de copie et l'operateur d'affectation en les rendant prives. Si nous tentons 
accidentellement de copier des instances de cette classe, le compilateur signale une erreur. 
Par exemple : 

class BankAccount 
{ 

Public 
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Private 

BankAccount (const BankAccount &other); 
BankAccount &operator=(const BankAccount &other); 

}; 

En Qt, beaucoup de classes sont concues pour etre utilisees en tant que classes de valeur. Elles 
disposent d'un constructeur de copie et d'un operateur d' affectation, et elles sont normalement 
instanciees sur la pile sans new. C'est le cas en particulier pour QDateTime, Qlmage, QString, 
et les classes conteneur telles que QList<T>, QVector<T>, et QMap<K, T>. 

Les autres classes appartiennent a la categorie "type reference", notamment QObject et ses 
sous-classes (QWidget, QTimer, QTcpSocket, etc.). Celles-ci possedent des fonctions virtuelles et 
ne peuvent pas etre copiees. Un QWidget represente par exemple une fenetre specifique ou un 
controle sur l'ecran. S'il y a 75 instances de QWidget en memoire, il y a aussi 75 fenetres et 
controles sur cet ecran. Ces classes sont typiquement instanciees a l'aide de l'operateur new. 



Variables globales et fonctions 

C++ autorise la declaration de fonctions et de variables qui n' appartiennent a aucune classe et 
qui sont accessibles dans n'importe quelle autre fonction. Nous avons etudie plusieurs exem- 
ples de fonctions globales, dont main ( ) , le point d'entree du programme. Les variables globa- 
les sont plus rares, parce qu' elles compromettent la modularite et la reentrance du thread. II est 
important de bien les comprendre parce que vous pourriez les retrouver dans du code ecrit par 
d'anciens programmeurs C ou d' autres utilisateurs de C++. 

Nous allons illustrer le fonctionnement des fonctions et variables globales en etudiant un petit 
programme qui affiche une liste de 128 nombres pseudo-aleatoires a l'aide d'un algorithme 
rapide et simple. Le code source du programme est reparti dans deux fichiers . cpp. 

Le premier est random . cpp : 

int randomNumbers[ 128] ; 

static int seed = 42; 

static int nextRandomNumber( ) 
{ 

seed = 1009 + (seed * 2011 ) ; 
return seed; 

} 

void populateRandomArray ( ) 
{ 

for (int i = 0; i < 128; ++i) 

randomNumbers[i] = nextRandomNumber( ) ; 

} 
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Dans ce fichier, deux variables globales (randomNumbers et seed) et deux fonctions globales 
(nextRandomNumber ( ) et populateRandomArray ( )) sont declarees. Deux declarations 
contiennent le mot-cle static ; elles ne sont visibles que dans l'unite de compilation 
courante (random . cpp) et on dit qu'elles ont une liaison statique. Les deux autres sont 
disponibles dans n'importe quelle unite de compilation du programme ; elles ont une liaison 
externe. 

La liaison statique est particulierement indiquee pour les fonctions assistantes et les variables 
internes qui ne doivent pas etre utilisees dans d' autres unites de compilation. Elle reduit le 
risque de collision d'identificateurs (variables globales de meme nom ou fonctions globales 
avec la meme signature dans des unites de compilation differentes) et empeche des utilisateurs 
malveillants ou tres maladroits d'acceder au code d'une unite de compilation. 

Examinons maintenant le second fichier, main. cpp, qui utilise les deux variables globales 
declarees avec une liaison externe dans random. cpp : 

#include <iostream> 

using namespace std; 

extern int randomNumbers [1 28] ; 

void populateRandomArray () ; 

int main() 
{ 

populateRandomArrayf ) ; 

for (int i = 0; i < 128; ++i) 

cout « randomNumbers[i] « endl; 
return 0; 

} 

Nous declarons les variables et fonctions externes avant de les appeler. La declaration de variable 
externe (qui rend la variable visible dans l'unite de compilation courante) pour random- 
Numbers debute avec le mot-cle extern. Sans ce mot-cle, le compilateur pourrait penser qu'il 
s'agit d'une definition de variable, et l'editeur de liens rapporterait une erreur pour la meme 
variable definie dans deux unites de compilation differentes (random . cpp et main . cpp). Vous 
pouvez declarer des variables autant de fois que vous voulez, mais elles ne doivent etre definies 
qu'une seule fois. C'est a partir de la definition que le compilateur reserve l'espace requis pour 
la variable. 

La fonction populateRandomArray ( ) est declaree avec un prototype de fonction. Le mot-cle 
extern est facultatif pour les fonctions. 

Nous pourrions typiquement placer les declarations de fonction et de variable externes dans un 
fichier d'en-tete et inclure ce dernier dans tous les fichiers qui en ont besoin : 

#ifndef RAND0M_H 
#define RANDOM H 
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extern int randomNumbers[128] ; 
void populateRandomArray ( ) ; 
#endif 

Nous avions deja vu comment coder static pour declarer des fonctions et variables membres 
qui ne sont pas associees a une instance specifique de la classe, et nous venons maintenant de 
voir comme utiliser ce mot-cle pour declarer des fonctions et variables avec une liaison stati- 
que. Notez qu'il existe un autre usage de static. En C++, nous pouvons declarer une variable 
locale avec ce mot-cle. De telles variables sont initialisees la premiere fois que la fonction est 
appelee et leur valeur est garantie entre plusieurs appels de fonction. Par exemple : 

void nextPrime( ) 
{ 

static int n = 1 ; 

do { 
++n; 

} while ( !isPrime(n) ) ; 
return n; 

} 

Les variables locales statiques sont similaires aux variables globales, mais elles ne sont visibles 
qu'a l'interieur de la fonction dans laquelle elles sont definies. 

Espaces de noms 

Les espaces de noms sont un mecanisme destine a reduire les risques de collision de noms dans 
les programmes C++. Ces collisions sont frequentes dans les gros programmes qui exploitent 
plusieurs bibliotheques tiers. Dans vos propres programmes, vous avez le choix de les utiliser 
ou non. 

Nous encadrons typiquement dans un espace de noms toutes les declarations d'un fichier d'en- 
tete arm de ne pas "polluer" l'espace de noms global avec les identificateurs qu'il contient. 
Par exemple : 

#ifndef SOFTWAREINC_RANDOM_H 
#define SOFTWAREINC_RANDOM_H 

namespace Softwarelnc 
{ 

extern int randomNumbers[ 128] ; 
void populateRandomArray( ) ; 

} 



#endif 



Annexe B 



Introduction au langage C++ pour les programmeurs Java et C# 51 9 



(Notez que nous avons aussi renomme la macro de preprocesseur utilisee pour eviter les inclu- 
sions multiples, reduisant ainsi le risque de collision de nom avec un richier d'en-tete de meme 
nom mais situe dans un repertoire different.) 

La syntaxe d'un espace de noms est similaire a celle d'une classe, mais la ligne ne se termine 
pas par un point- virgule. Voici le nouveau richier random . cpp : 

#include "random. h" 

int Softwarelnc: : randomNumbers[128] ; 

static int seed = 42; 

static int nextRandomNumber( ) 
{ 

seed = 1009 + (seed * 2011 ) ; 
return seed; 

} 

void Softwarelnc: :populateRandomArray() 
{ 

for (int i = 0; i < 128; ++i) 

randomNumbers[i] = nextRandomNumber( ) ; 

} 

Contrairement aux classes, les espaces de noms peuvent etre "reouverts" a tout moment. 
Par exemple : 

namespace Alpha 
{ 

void alphal ( ) ; 
void alpha2( ) ; 

} 

namespace Beta 
{ 

void betal ( ) ; 

} 

namespace Alpha 
{ 

void alpha3( ) ; 

} 

Vous avez ainsi la possibilite de definir des centaines de classes, situees dans autant de fichiers 
d'en-tete, dans un seul espace de noms. La bibliotheque standard C++ englobe ainsi tous ses 
identificateurs dans 1' espace de noms std. Dans Qt, les espaces de noms servent pour des identi- 
ficateurs de type global tels que Qt : : AlignBottom et Qt : : yellow. Pour des raisons historiques, 
les classes de Qt n'appartiennent a aucun espace de noms mais sont prefixees de la lettre "Q". 
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Pour se referer a un identiricateur declare dans un espace de noms depuis l'exterieur de cet 
espace, nous le prefixons avec le nom de 1' espace de noms (et : :). Nous pouvons aussi faire 
appel a l'un des trois mecanismes suivants, qui visent a reduire la frappe. 

• Definir un alias d'espace de noms : 

namespace ElPuebloDeLaReinaDeLosAngeles 
{ 

void beverlyHills( ) ; 
void culverCity ( ) ; 
void malibu() ; 
void santaMonica( ) ; 

} 

namespace LA = ElPuebloDeLaReinaDeLosAngeles; 

Apres la definition de 1' alias, celui-ci peut etre employe a la place du nom original. 

• Importer un identificateur unique depuis un espace de noms : 

int main() 
{ 

using ElPuebloDeLaReinaDeLosAngeles: :beverlyHills; 
beverlyHills( ) ; 

}" 

La declaration using nous permet d'acceder a un identiricateur donne dans un espace de 
noms sans avoir besoin de le prefixer avec le nom de 1' espace de noms. 

• Importer un espace de noms complet via une unique directive : 

int main() 
{ 

using namespace ElPuebloDeLaReinaDeLosAngeles; 
santaMonicaf ) ; 
malibu() ; 

} 

Cette approche augmente les risques de collision de noms. Des que le compilateur signale un 
nom ambigu (deux classes de meme nom, par exemple, definies dans deux espaces de noms 
differents), nous sommes toujours en mesure de qualifier l'identificateur avec le nom de 
l'espace de noms lorsque nous avons besoin d'y faire reference. 

Le preprocesseur 

Le preprocesseur C++ est un programme qui convertit un fichier source .cpp contenant des 
directives #- (telles que #include, #ifndef, et #endif) en fichier source ne contenant 
aucune directive de cette sorte. Ces directives effectuent des operations de texte simples sur le 
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fichier source, comme une compilation conditionnelle, une inclusion de fichier et une expan- 
sion de macro. Le preprocesseur est normalement invoque automatiquement par le compila- 
teur, mais dans la plupart des systemes vous avez encore la possibility de l'invoquer seul 
(souvent par 1' intermediate d'une option de compilateur -E ou /E). 

• La directive #include insere localement le contenu du fichier indique entre crochets (<>) 
ou guillemets doubles (""), selon que le fichier d'en-tete est installe sur un emplacement 
standard ou avec les fichiers du projet courant. Le nom de fichier peut contenir . . et / (que 
les compilateurs Windows interpretent correctement comme etant des separateurs de reper- 
toire). Par exemple : 

#include " . . /shared/globaldefs.h" 

• La directive #def ine definit une macro. Les occurrences de la macro qui apparaissent apres la 
directive #def ine sont remplacees par la definition de la macro. Par exemple, la directive 

#define PI 3.14159265359 

demande au preprocesseur de remplacer toutes les futures occurrences du jeton PI dans l'unite 
de compilation courante par le jeton 3.14159265359. Pour eviter les collisions entre noms de 
variable et de classe, on affecte generalement aux macros des noms en majuscules. Nous pouvons 
tres bien definir des macros qui recoivent des arguments : 

#define SQUARE(x) ((x) * (x)) 

Dans le corps de la macro, il est conseille d'encadrer toutes les occurrences des parametres par 
des parentheses, ainsi que le corps complet, pour eviter les problemes de priorite des opera- 
teurs. Apres tout, nous voulons que 7*SQUARE (2+3) soit developpe en 7* ( (2+3) * (2+3) ), et 
non en 7*2+3*2+3. 

Les compilateurs C++ nous permettent normalement de definir des macros sur la ligne de 
commande, via l'option -D ou /D. Par exemple : 

CC -DPI=3. 14159265359 -c main.cpp 

Les macros etaient tres populaires avant l'arrivee des typedef, enumerations, constantes, fonc- 
tions inline et modeles. Leur role aujourd'hui consiste surtout a proteger les fichiers d'en-tete 
contre les inclusions multiple. 

• Vous annulez la definition d'une macro a tout moment a l'aide de #undef : 
#undef PI 

C'est pratique si nous avons l'intention de redefinir une macro, puisque le preprocesseur 
interdit de definir deux fois la meme macro. Ca sert aussi a controler la compilation condi- 
tionnelle. 
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• Vous traitez des parties du code ou vous les sautez en codant #if, #elif, #else, et 
#endif , en fonction de la valeur numerique des macros. Par exemple : 

#define N0_0PTIM 0 
#define 0PTIM_F0R_SPEED 1 
#define 0PTIM_F0R_MEM0RY 2 

#define OPTIMIZATION OPTIM FOR MEMORY 



#if OPTIMIZATION == 0PTIM_F0R_SPEED 
typedef int Mylnt; 

#elif OPTIMIZATION == 0PTIM_F0R_MEM0RY 

typedef short Mylnt; 

#else 

typedef long long Mylnt; 
#endif 

Dans l'exemple ci-dessus, seule la deuxieme declaration de typedef devra etre traitee par le 
compilateur, Mylnt etant ainsi defini comme un synonyme de short. En changeant la defini- 
tion de la macro OPTIMIZATION, nous obtenons des programmes differents. Lorsqu'une 
macro n'est pas definie, sa valeur est consideree comme etant 0. 

Une autre approche de la compilation conditionnelle consiste a tester si une macro est definie 
ou non. Vous procedez en codant l'operateur defined ( ) comme suit : 

#define OPTIM FOR MEMORY 



#if defined (0PTIM_F0R_SPEED) 

typedef int Mylnt; 

#elif defined (0PTIM_F0R_MEM0RY) 

typedef short Mylnt; 

#else 

typedef long long Mylnt; 
#endif 

• Pour des raisons pratiques, le preprocesseur reconnait #ifdef Xet#ifndef X comme des 
synonymes de #if defined (X) et #if ! defined (X). Vous protegez un fichier d'en-tete 
des inclusions multiple en encadrant son contenu comme ci-apres : 

#ifndef MYHEADERFILE_H 
#define MYHEADERFILE H 



#endif 
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La premiere fois que le fichier d'en-tete est inclus, le symbole MYHEADERFILE_H n'est pas 
derini, done le compilateur traite le code entre #if ndef et #endif . La seconde et toutes les 
fois suivantes ou le fichier d'en-tete est inclus, MYHEADERFI LE_ H est deja derini, done le bloc 
#ifndef ... #endif complet est ignore. 

• La directive #error emet un message d'erreur defini par l'utilisateur au moment de la 
compilation. Elle est souvent associee a une compilation conditionnelle pour signaler un 
cas impossible. Par exemple : 

class UniChar 
{ 

Public 

#if BYTE_ORDER == BIG_ENDIAN 

uchar row; 

uchar cell; 
#elif BYTE_ORDER == LITTLE_ENDIAN 

uchar cell; 

uchar row; 
#else 

#error "BYTE_ORDER must be BIG_ENDIAN or LITTLE_ENDIAN " 
#endif 

}; 

Contrairement a la plupart des autres constructions C++, pour lesquelles les espaces n'etaient 
pas significatifs, les directives de preprocesseur doivent apparaitre sur leur propre ligne, sans 
point- virgule a la fin. Les directives tres longues peuvent occuper plusieurs lignes en terminant 
chacune d'elles sauf la derniere par un slash inverse (\). 



La bibliotheque C++ standard 

Dans cette section, nous allons rapidement passer en revue la bibliotheque C++ standard. La 
Figure B.3 repertorie les principaux fichiers d'en-tete C++. Les en-tetes <exception>, <limits>, 
<new>, et <typeinf o> prennent en charge le langage C++ ; par exemple, <limits> nous 
permet de tester les proprietes du support arithmetique des types entier et virgule flottante sur 
le compilateur, et <typeinf o> offre une introspection de base. Les autres en-tetes fournissent 
generalement des classes pratiques, notamment une classe chaine et un type numerique 
complexe. La fonctionnalite offerte par <bitset>, <locale>, <string>, et <typeinfo> 
reprend largement celle des classes QBitArray, QLocale, QString, et QMetaObj ect de Qt. 

Le C++ standard inclut aussi un ensemble de fichiers d'en-tete qui traitent les E/S, enumeres 
en Figure B.4. La conception des classes d' entrees/sorties standard datant des annees 80, elles 
sont assez complexes et done difficiles a etendre. L operation est d'ailleurs tellement complexe 
que des livres complets ont ete ecrits sur le sujet. Le programmeur herite d'ailleurs avec ces 
classes d'un bon nombre de problemes non resolus lies au codage des caracteres et aux repre- 
sentations binaires dependantes de la plate-forme des types de donnees primitifs. 
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Fichier d'en-tete 


Description 


<bitset> 


Classe modele pour representer des sequences de bits de longueur fixe 


<complex> 


Classe modele pour representer des nombres complexes 


<exception> 


Types et fonctions lies a la gestion des exceptions 


<limits> 


Classe modele qui specifie les proprietes des types numeriques 


<locale> 


Classes et fonctions liees a la localisation 


<new> 


Fonctions qui gerent 1' allocation de memoire dynamique 


<stdexcept> 


Types d'exception predefinis pour signaler les erreurs 


<string> 


Conteneur de chaines modele et caracteristiques des caracteres 


<typeinf o> 


Classe qui fournit des informations de base concernant un type 


<valarray> 


Classes modele pour representer des tableaux de valeurs 


Figure B.3 

Principaux fichiers d'en-tete de la bibliotheque C+ + 


Fichier d'en-tete 


Description 


<f stream> 


Classes modele qui manipulent des fichiers externes 


<iomanip> 


Manipulateur de flux d'E/S qui recoit un argument 


<ios> 


Classe de base modele pour les flux d'E/S 


<iosfwd> 


Declarations anticipees pour plusieurs classes modeles de flux d'E/S 


<iostream> 


Flux d'E/S standard (cin, cout, cerr, clog) 


<istream> 


Classe modele qui controle les entrees en provenance d'une memoire tampon de flux 


<ostream> 


Classe modele qui controle les sorties vers une memoire tampon de flux 


<sstream> 


Classes modele qui associent des memoires tampon de flux avec des chaines 


<streambuf > 


Classes modele qui placent en memoire tampon les operations d'E/S 



<St rst ream> Classes pour effectuer des operations de flux d'E/S sur des tableaux de caracteres 



Figure B.4 

Fichiers d'en-tete de la bibliotheque d'E/S C+ + 
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Le Chapitre 12 consacre aux entrees/sorties detaille les classes Qt correspondantes, qui presen- 
tent les entrees/sorties Unicode ainsi qu'un jeu important de codages de caracteres nationaux et 
une abstraction independante de la plate -forme pour stocker les donnees binaires. Les classes 
d'E/S de Qt forment la base des communications interprocessus, de la gestion de reseau, et du 
support XML de Qt. Les classes de flux de texte et binaire de Qt sont tres faciles a etendre pour 
prendre en charge les types de donnees personnalises. 

La bibliotheque STL (Standard Template Library) existe depuis les annees 90 et propose un 
jeu de classes conteneur, iterateurs et algorithmes bases sur des modeles, qui font maintenant 
partie de la norme standard ISO C++. 

La Figure B.5 enumere les fichiers d'en-tete de la STL. La conception de cette bibliotheque est 
rigoureuse, presque mafhematique, et elle fournit une fonctionnalite generique securisee au 
niveau des types. Qt fournit ses propres classes conteneur, dont la conception s'inspire de celle 
de la STL. Ces classes sont detaillees au Chapitre 1 1 . 



r IL filer LI c/i- fete 


LsciLf lyilUTl 


<algorithm> 


Fonctions modele a usage general 


<deque> 


Conteneur modele de file d'attente a double acces 


<f unctional> 


Modeles d'aide a la construction et manipulation des functeurs (objets fonction) 


<iterator> 


Modeles d'aide a la construction et manipulation des iterateurs 


<list> 


Conteneur modele de listes doublement chainees 


<map> 


Conteneurs modele de map a valeur unique ou multiple 


<memory> 


Utilitaires pour simplifier la gestion de memoire 


<numeric> 


Operations numeriques modeles 


<queue> 


Conteneur modele de files d'attente 


<set> 


Conteneurs modele d' ensembles a valeur unique ou multiple 


<stack> 


Conteneur modele de piles 


<utility> 


Fonctions modele de base 


<vector> 


Conteneur modele de vecteurs 



Figure B.5 

fichiers d'en-tete de la STL 



C++ etant surtout une version amelioree du langage de programmation C, les programmeurs 
C++ disposent aussi de la bibliotheque C complete. Les fichiers d'en-tete C sont disponibles 
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soit sous leurs noms traditionnels (par exemple <stdio.h>) soit sous leur forme moderne avec 
le prefixe c- et sans l'extension . h (<cstdio>, par exemple). Lorsque nous codons avec le nom 
moderne, les fonctions et types de donnees sont declares dans l'espace de noms std. (Cela ne 
s' applique pas a des macros telles que ASSERT ( ) , parce que le preprocesseur ne connait pas les 
espaces de noms.) La nouvelle syntaxe est recommandee si votre compilateur la prend en charge. 

La Figure B.6 repertorie les richiers d'en-tete C. La plupart proposent une fonctionnalite qui 
recouvre celle de richiers d'en-tete C++ ou de Qt plus recents. Notez que <cmath> est une 
exception, ce fichier declare des fonctions mathematiques telles que s in ( ) , sq rt ( ) , et pow ( ) . 



Fichier d'en-tete 


Description 


<cassert> 


La macro ASSERT() 


<cctype> 


Fonctions pour classer et faire correspondre les caracteres 


<cerrno> 


Macros liees au signalement des conditions d'erreur 


<cf loat> 


Macros specifiant les proprietes des types virgule flottante primitifs 


<ciso646> 


Autres orthographes pour les utilisateurs du jeu de caracteres ISO 646 


<climits> 


Macros specifiant les proprietes des types entiers primitifs 


<clocale> 


Fonctions et types lies a la localisation 


<cmath> 


Fonctions et constantes mathematiques 


<csetjmp> 


Fonctions pour executer des branchements non locaux 


<csignal> 


Fonctions pour gerer les signaux du systeme 


<cstdarg> 


Macros pour implementer les fonctions a liste d' argument variable 


<cstddef > 


Definitions courantes de plusieurs en-tetes standard 


<cstdio> 


Fonctions pour effectuer les E/S 


<cstdlib> 


Fonctions utilitaires generates 


<cstring> 


Fonctions pour manipuler les tableaux de caracteres 


<ctime> 


Types et fonctions pour manipuler le temps 


<cwchar> 


Fonctions de manipulation de chaines de caracteres etendus 


<cwctype> 


Fonctions pour classer et faire correspondre les caracteres etendus 



Figure B.6 

Fichiers d'en-tete C+ + pour les utilitaires de bibliotheque C 
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Cette rapide presentation de la bibliotheque C++ standard s'acheve a present. Dinkumware 
propose sur Internet une documentation de reference complete concernant la bibliotheque C++ 
standard a l'adresse http://www.dinkumware.com/refxcpp.htrnl, et SGI offre un guide du 
programmeur STL a l'adresse http://www.sgi.com/tech/stl/. La definition officielle de cette 
bibliotheque se trouve avec les standard C et C++, disponibles sous forme de fichiers PDF ou 
de copies papier a demander aupres de l'organisation ISO (International Organization for 
Standardization). 

Cette annexe traite en tres peu de pages un sujet normalement fort etendu. Quand vous allez 
commencer a etudier Qt a partir du Chapitre 1 , vous allez decouvrir que la syntaxe est beau- 
coup plus simple que cette annexe ne pouvait le laisser supposer. Vous pouvez tres bien 
programmer en Qt en faisant uniquement appel a un sous-ensemble de C++ et sans avoir 
besoin de la syntaxe plus complexe que vous pouvez retrouver dans ce langage. Des que vous 
aurez commence a saisir du code et a creer et lancer vos executables, vous ne pourrez que 
constater a quel point l'approche de Qt est simple et claire. Et des que vous aborderez des 
programmes plus ambitieux, en particulier ceux qui ont besoin d'un graphisme performant et 
elabore, la combinaison C++/Qt continuera a vous donner toute satisfaction. 
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#define 487, 521 
#endif 445, 487 
#ifdef 445 
#ifndef 487 
#include 486, 521 
#undef 521 
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<algorithm> 276 
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<iostream> 86 
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About Qt 53 

about() (QMessageBox) 70 
accept() 411 

QDialog 31, 36 
Acceptable (QSpinBox) 107 
acceptProposedAction() 215 
acquire() 414, 415 
Action 5 1 

About Qt 53 

Auto-Recalculate 52 

exit Action 53 

New 51 



Open 52 

Save 52 

Save As 52 

Select All 52 

Show Grid 52 
activateWindow() 65 
Active (groupe de couleurs) 1 15 
activeEditor() 162 
ActiveQt 448 
ActiveX 460 

sous Windows 448 
addAction() (QMenu) 54 
addBindValue() 313 
addCd() 326 
addChildSettings() 235 
addDatabase() 311, 314 
addltem() (QComboBox) 241 
addLibraryPathO 435 
addMenu() (QMenu) 54 
AddRef() 456 
addRow() 233 
addStretch() 148 
addTrack() 327 
addTransaction() 420-421 
addWidget() 147, 151 

QStatusBar 57 
adjust() 139 

PlotSettings 134 
adjustAxis() 139 
adjusted() 130 



adjustSize() 127 
Aide en ligne 373 
Assistant Qt 379 
avec 1' assistant 379 
infobulle 374 
informations d'etat 374 
QTextBrowser 376 
Qu'est-ce que c'est ? 374 
Algorithme 

generique 276 

qBinaryFind 277 
qCopy 277 
QCopyBackward() 
285 

qDeleteAll 278 
qEqual() 285 
qFill 277 
qFind 276 
qSort 277 
qStableSort 278 
qSwap 278 
AlignHCenter 57 
alignment 137 
Anticrenelage 186, 189 

base sur X Render 197 
AnyKeyPressed (QAbstract- 

ItemView) 231 
API natives 444 
append() 265 

QString 279 
Apple Developer Connection 
479 
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Application 
Age 7 

capable de gerer les plug-in 
435 

Carnet d'adresse 458 
CD Collection 317 
Cities 246 
Color Names 240 
Coordinate Setter 232 
Currencies 243 
Directory Viewer 238 
ecrire des plug-in 439 
Flowchart Symbol Picker 
230 

Image Converter 303, 353 
Image Pro 419 
implementer la fonctionnalite 
77 

infobulle et information 

d'etat 374 
Mail Client 154 
MDI Editor 160 
ouverte aux traductions 390 
Project Chooser 216 
Quit 7 

Regexp Parser 25 1 

Settings Viewer 234 

Splitter 152 

Spreadsheet 46, 92 

Team Leaders 236 

Tetrahedron 207-208 

Threads 409 

Tic-Tac-Toe 462 

traduire 402 

Trip Planner 343 

Windows Media Player 448 
apply() 422-423 
applyEffect() 438-440 
appTranslator 398, 401 
Architecture modele/vue 228 
arg() 279, 392 

QString 62 
ARGB32 197 



arguments() 330 

Q Application 168 
Assistant Qt 10, 379 
asVariant() 452 
at() 271 
Attribut 

WA_DeleteOnClose 74, 
162 

WA_StaticContents 117 
Auto-Recalculate 52, 71, 75, 79 
avg() 104 
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BackgroundColorRole 242, 256 
Barre d'etat, configurer 56 
Barre d'outils 

ancrable 157 

creer 51 
Base de donnees 309 

connexion et execution de 
requetes 310 

formulaires 321 

presenter les donnees 317 
beforelnsertO 320, 325 
begin() 269 
beginGroupO 71 
Bibliotheque 

C++ standard 523 

dynamique 425, 488 

E/S C++ 524 

OpenGL 207 

statique 488 

STL 63 
bindValue() 313 
Boite de dialogue 

About 69 

conception rapide 25 
creer 15 
de feedback 44 
dynamique 39 
etapes de creation 26 
extensible 33 
Find 16 



Go-to-Cell 26 
integree 40 
multiforme 32 
multipage 39 

QDialog (classe de base) 16 

Sort 33 

utiliser 64 
bool 489 
Boucle 

d'evenement 4, 178 

foreach 271 

while 417 
boundingRect() (QPainter) 204 
break 273 
BufferSize 416 
buttons() (QMouseEvent) 117 

c 



c# 

differences avec C++ 489 
differences avec Java 483 

C++ 

chaines de caracteres 505 
definitions de classe 490 
destructeur 496 
differences avec Java et C# 
489 

enumerations 507 

espaces de noms 518 

heritage 493 

pointeurs 497 

polymorphisme 493 

preprocesseur 520 

presentation 483 

surcharge d'operateur 512 

tableaux 502 

typeDef 509 

types valeur 514 
cachedValue 97, 100 
cachelsDirty 97, 98 
cachels Valid 100 
canRead() 428, 429 
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canReadLine() 352 
capabilities() 427 

CanRead 428 

CanReadlncremental 428 

CanWrite 428 
Capuchon 185 
cascade() 164 
CaseSensitivity 17 
cd() 333 
cdModel 325 
cdTableView 325, 327 
Cell 79, 81, 90, 96 

arbre d'heritage 79 
cell() 83, 90 
cerr 486 

Chaines de caracteres 505 
changeEvent() 401 
char 386, 489 
characters() 362-363 
Chargement 85 
charset 224 
checkable 33 
Classe 

a acces aleatoire 

QBuffer 288 

QFile 288 

QTemporaryFile 288 
conteneur 263 

iterateurs 267 
QBrush 271 
QByteArray 266, 271 
QCache 275 
QDateTime 266 
QFont 271 
QHash 264, 273 
Qlmage 271 
QLinkedList 264-266 
QList 264 
QList<T> 266 
QMap 264, 273 
QPair 285 
QPixmap 271 
QRegExp 266 
QSet 275 
QString 266, 271 



QVariant 266 
QVarLengthArray 
<T,Prealloc> 285 
QVector 264, 266 

d'affichage d' elements 227 
QListWidget 228 
QTableWidget 228 
QTreeWidget 228 
utiliser 229 

d' elements 82 

de modele 244 

QAbstractltemModel 
244 

QAbstractListModel 
244 

QAbstractTableModel 
244 

de widgets 40 

QByteArray 278 

QString 278 

QVariant 278 

sequentielle 

QProcess 288 
QTcpSocket 288 
QUdpSocket 288 

TextArtDialog 437 

wrapper de plug-in 426 
Cle 71 

clear() 81, 82, 252, 278, 400 

Spreadsheet 58 
clearCurve() 129 
clicked() 7, 170, 304 
Client 

FTP 330 

HTTP 339 

TCP 342 
ClientSocket 349-350 
clipboard() 88, 224 
clone() 98, 514 
close() 19, 61, 74, 164,333 
closeActiveWindow() 164 
closeAHWindows() 74, 164 
closeConnection(), TCP 348 
closeEditor() 260 
closeEventQ 70, 164, 167 



MainWindow 74 

QWidget 47, 61 
codecForNameO 389 
CodeEditor 171 
ColorGroup 115 
ColorNamesDialog 240 
column() (QModellndex) 242 
columnCount() 82, 244 
columnSpan 148 
COM, objets 448 
commit() 313 

commitAndCloseEditorO 259 
commitData() 464 
Communication inter-processus 
303 

Compagnon 18 
compareO 68, 94-95 
Compilateur 

execution 486 

macros 446 

MinGW C++ 478 

moc 22 

uic 29 

unites 484 
Composition (mode) 188, 198 
CompositionMode_SourceOver 
198 

CompositionMode_Xor 199 
connect() 19, 192, 419, 423 

QObject 9, 23 
connected() 344, 345 
connectionClosedByServer() 349 
connectToHostO 333, 345 
connectToServer() 345 
Connexion 

aux bases de donnees 310 

de requetes 310 

etablir 6 

signal/slot 304 
const 499 

const_cast<T>() 510 
constData() 283 
Constructeur de copie 514 
containsQ (QRect) 117 
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Conteneur 

associatif 264, 273 
QCache 275 
QHash<K,T> 264, 273 
QMap<K,T> 264, 273 
QSet 275 

copie 270 

sequentiel 264 

QLinkedList 266 
QLinkedList<T> 264- 
265 

QList<T> 264, 266 
QQueue<T> 266 
QStack<T> 266 
QVector 264 
QVector<T> 264, 266 
contentsChanged( ) 1 66- 1 67 
contextMenuEvent() (QWidget) 
55, 67 

ContiguousSelection 81, 89 
continue 273 
Controle ActiveX 448 
controllingUnknown() 456 
Conversions de type 509 
ConvertDepthTransaction 422 
convertTolBitO 420 
convertTo32Bit() 420 
convertTo8Bit() 420 
convertToFormat() 112 
Coordonnees 

conversion logiques- 
physiques 190 

systeme par defaut 188 
copy() 88 
Copy Action 218 
copyAvailable() 162 
count() 265 
Courbe de Bezier 186 
cout 486 
Crayon 185 
create() 121, 427-428 
createActions() 49, 376, 398 
createConnection() 311, 313 
createContextMenu() 49 
createEditorO 161, 258, 260 



createlndex() 249 
createLanguageMenu() 399-400 
createMenus() 49, 164, 398 
createStatusBar() 49, 56 
createToolBars() 49 
critical() (QMessageBox) 59 
curFile 62, 167 
currencyAt() 246 
CurrencyModel 243 
currentCdChanged() 324 
currentCellChanged() 57 
currentDateTime() (QDateTime) 
193 

currentFormulaQ 84 
currentlndex() (QComboBox) 68 
currentltem 364 
currentLocation() 84 
currentRow 151 
currentRowChanged() 151 
currentText 363 
currentThreadO 417 
Curseur 452 
CursorHandler 428, 434 
curveMap 129 
curZoom 127 
CustomerlnfoDialog 176 
cut() 88 

Editor 163 

D 



data() 99, 244-245, 283 
QMimeData 219 
QTableWidgetltem 96 

dataChanged() 249 
QClipboard 225 

Datagramme UDP 353 

DataSize 416 

debug 5 

Declaration prealable 16 
default 33 
definedO 522 
Definition de classe 490 



Degrade 

circulaire 188 

conique 188 

lineaire 187 
del() 90 
Delegue 228 

personnalise 256 
delete 90, 252 
deleteLater() 350 
delta() 135 
Derivation 

QDialog 16 

QMainWindow 46 

QMimeData 224 

QTableWidget 78 

QTableWidgetltem 96 

QWidget 108 
Dessin 

courbe de Bezier 186 

crayon 185 

degrades 

circulaires 188 
coniques 188 
lineaires 187 

formes geometriques 186 

pinceau 185 

police 185 

QPainter 184 

rectangle sans anticrenelage 

189 
styles 

de capuchon et jointure 
185 

de crayon 185 

trace 187 

viewport 189 
DiagCrossPattern 187 
Dinkumware 527 
Directives 445 

#include 486 

de preprocesseur 487 
Disabled (groupe de couleurs) 
115 

disconnect) 423 
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disconnected*;) 344, 349 
DisplayRole 97, 99, 242, 245 
Disposition 7, 28, 144 

empilee 150 

gerer 143 

gestionnaires 9, 146 
manuelle 145 

positionnement absolu 144 
distances 248 
DLL 425, 488 
Document 

multipage 201 

multiple 72 
Documentation de reference 10 
documentElement() 367 
documentTitleO 378 
documentWasModified() 166 
DOM (Document Object Model) 
359 

DomParser 367 
done() 231, 331 
Donnee 

binaire 

ecriture 288 
lecture 288 

les stacker en tant 
qu'elements 82 

presentation sous forme 
tabulaire 317 

types primitifs 489 
DontConfirmOverwrite 

(QFileDialog) 61 
double 489 

mise en memoire tampon 122 
dragEnterEvent() 214-215 
dragMoveEvent() 218 
draw() 184, 194, 209 

dessin d'un tetraedre 210 
drawCurves() 136, 138 
drawDisplay() 259 
drawFocus() 259 
drawGrid() 136 
drawLine() 196 

QPainter 114 



drawPie() 186 
drawPolygon() 195 
drawPolyline() 138 
drawPrimitive() 130 

QStylePainter 130 
drawRect() 189 
drawText() 137, 196 

conversion des coordonnees 
190 

dropEvent() 214 

glisser-deposer 215 
dumpdoc 451 
duration() 193 
dynamic_cast<T>() 510 
dynamicCallO 452 

E 



E_NOINTERFACE 456 
Echelon 140 
Ecriture 

code XML 370 

donnees binaires 288 

texte 294 
Editeur 

de connexion (Qt Designer) 
37 

de liens 485 
editingFinished() 259 
Editor 164 

cut() 163 

fonctions 165 

save() 162 
EditRole 97-99, 242 
effects() 436, 439 
Ellipse (dessiner) 186 
emit 21 
enabled 27 

enableFindButtonO 19, 21 
end() 269 

conteneur non const 271 
endElement() 360, 362, 364 
endGroupO 71 
endl 486 



endsWith() 281 

enterErrorState() 431 

Entrees/sorties 287 

lire et ecrire des donnees 

binaires 288 
lire et ecrire du texte 294 
parcourir les repertoires 300 

entry Height() 203, 204 

entryList() 301 

Enumerations 507 

Equivalence pointeurs/tableaux 
503 

eraseRect() 440 
error() 306, 344, 349 
errorStringO 363 
escape() 221 
Espace de noms 518 

std 125 
Espacement 20 

evalExpression() 100-101, 104 
evalFactorO 101, 104 
evalTermO 101-104 
Evenement 4 

boucle 178 

close 164 

drop 214 

filtre 175, 177 

gestionnaires, reimplementer 
170 

key 170 

paint 113, 118 

propagation 178 

resize 131 

timer 172 

traiter 169, 177 

versus signal 170 

wheel 135 
event() 170 
eventFilter() 176 
exec() 66, 312, 418 

QApplication 178 

QDialog 66 

QPrintDialog 200 

requete SQL 311 
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Executable 485 

integrer des donnees 302 
execute() 307 

QProcess 307 
exitAction 53 
expand() 239 
Expanding 149 
explicit 511 
Expression 101 

reguliere 250 

syntaxe 101 
extern 517 

F 



faceAtPosition() 211-212 
fatalError() 362, 364 
Fenetre 

d' application 
QDialog 4 
QMainWindow 4 
dessin 188 
modale 66 
non modale 64 
principale 

configurer 49 
creer 45 
Fichier d'en-tete 18, 48 
<QtAlgorithms> 276 
<QtGui> 18 
definition 487 
Fichier objet 485 
ffflO (QPixmap) 136 
fillRectO (QPainter) 116 
Filtre 

cin en cout 299 
d'evenement 446 

installer 169, 175 
entrees du systeme 
de fichiers 238 
findO 444 

findChild<T>() (QObject) 40 
findClickedQ 19, 21 



findNext() 17, 21, 65, 91 
findPreviousO 17, 21, 65, 92 
finished() 306, 422 
firstChild() 369 
flags() 247, 249 
flipHorizontallyO 420 
FlipTransaction 422 
flipVerticallyO 420 
float 489 
flushO 289 

focusNextChildO 175, 177 
Fonction 

globale 485, 516 

prototype 486 

virtuelle pure 494 
fontMetricsO (Q Widget) 174 
FontRole 242, 256 
foreach 75, 505 
foregroundQ (QPalette) 115 
FOREIGN KEY 318 
forever 347 
formats() 222-223 

ARGB32 premultiplie 197 
formula() 83 
Formulaire 

creer a l'aide de QWidget 
108 

developpement 26 
disposition des widgets 28 
inserer un HexSpinBox 118 
maTtre/detail 321 
modifier la conception 32 
nommer les widgets 35 

Frameworks de migration 
Qt/Motif et Qt/MFC 444 

Froglogic 444 

fromAsciiO 283 

fromLatinlO 283 

fromPage() (QPrinter) 205 

ftpDone() 331 

FtpGet 330 

ftpDone() 331 

ftpListlnfoO, urllnfo 336 



G 



generateDocumentation() 45 1 
generateld() 320 
generateRandomTrip() 35 1 
geometry() (QWidget) 72 
Gestion de session 

tests et debogage 467 
Xll 461 
Gestionnaire 

d'evenements 

endElement() 360 
reimplementer 170 
startElement() 360 
de disposition 9, 146 

QGridLayout 9, 146 
QHBoxLayout 9, 146 
QVBoxLayout 9, 146 
get() 330, 332-333, 337 

operations HTTP 339 
getColor() (QColorDialog) 211 
getDC() 445 
getDirectory() 335 
getFileQ 330, 332 

operations HTTP 340 
GetlnterfaceSafetyOptionsQ 456 
getOpenFileName() 
(QFileDialog) 59 
getSaveFileName() 
(QFileDialog) 61 
GL_SELECT 212 
glClearColor() 209 
glClearIndex() 209 
glColor3d() 210 
gllndex() 210 

Glisser, types personnalises 219 
Glisser-deposer 213 

activer 214 

QTableWidget 219 
GNU (General Public License) 

478 
Go to Cell 27 
GoToCellDialog 27 
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Graphique 
2D 183 
3D 183 
OpenGL 207 

group() 120 

Groupe de couleurs 
Active 115 
Disabled 115 
Inactive 115 

guidgen 457 

GuiServer 471 

H 



Handle 444, 446 
hasAcceptableInput() 

(QLineEdit) 32 
hasFeature() 313 
hasLocalData() 418 
hasNext() 267 
hasPendingEvents() 181 
hasPrevious() 268 
head() 341 

headerData() 244-245, 248, 256 
Hello Qt 4 

HelpBrowser 377, 380 
Heritage 493 

HexSpinBox 106, 108, 118 
hide() 128 

hideEvent() 173, 175 
hostName 392 

I 



IANA (Internet Assigned 

Numbers Authority) 215 
icon() 120 

IconEditor 109, 115, 120, 122 

pixelRectO 115 
IconEditorPlugin 120 
iconForSymbolO 231 
iconImage() 109-110, 113 
Identifiant de la fenetre 444 



Ignore Action 218 
image() 110,421 

presse-papiers 224 
imageCount() 433 
imageSpace() 300-301 
ImageWindow 420 
Impression 199 

QPainter 205 

QTextDocument 202 
Inactive (groupe de couleurs) 115 
includeFile() 120 
incomingConnection() 349-350 
index() 253 

de modele 249 
indexOfO 150, 280 
Infobulle 374 

information() (QMessageBox) 59 
initFrom() 130, 136, 198 
initializeGL() 208-209 
insertO 237, 281 

avec iterateur 269 

dans map 273 
insertMulti() 274-275 
insertRowO 233, 315 
installEventFilter() 176-177 
instance() (QPluginLoader) 438 
Instruction 

DELETE 314 

GET 337 

if 417 

INSERT 313-314 
SELECT 312, 314 
UPDATE 314 
int 312, 489 

Interface avec les API natives 444 
Intermediate 107 

QSpinBox 107 
Internationalisation 385 

passer dynamiquement 

d'une langue a l'autre 396 
traduire les applications 390, 

402 
Unicode 386 



Internet Explorer 

acces a l'aide 380 
integrer un widget 453 
options de securite 
du composant 455 

Introspection 25 

Invalid 107 

QSpinBox 107 

invokeMethod() 424 

IObjectSafety 455 

isActive() 312 

isalpha() 387 

isContainer() 121 

isdigit() 387 

isEmptyO 282 

conteneur 269 

isLetter() 387 

isLetterOrNumberO 387 

isLower() 387 

isMark() 387 

isNumber() 387 

isPrint() 387 

isPunctO 387 

isSessionRestored() 467 

isSpace() 387 

isSymbolO 387 

isUntitled 165, 167 

isUpper() 387 

item->text() 231 

itemChanged() 81 

ItemlsEditable 249 

Iterateur 

de style Java 267 
de style STL 269 
mutable 268 
pour liste chainee 265 

J 



Java 

differences avec C# 483 
differences avec C++ 489 
machines virtuelles 470 
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join() 282 
Jointure 185 
Journal View 401 
jumpToNextlmageO 433 

K 



KDE XIV 

fermeture de session 461 

projet XVIII 
key() 138, 169, 246, 275-276 

map 275 
keyPressEvent() 135, 170-171, 
175 

Plotter 139 
keyReleaseEvent() 170 
keys() 274, 427 

iterateur STL 276 
killTimerO (QObject) 175 
Klaralvdalens Datakonsult 444 

L 



LanguageChange 402 
LargeGap 203 
Latin- 1 386 

LD_LIBRARY_PATH 481 

leaders() 238 

Lecture 

code XML 360, 365 
donnees binaires 288 
texte 294 

left() 280, 283 

LeftDockWidgetArea 158 

length() 279, 282 

LinkAction 218 

list() 333 

Liste chainee 265 

load() 394, 401 

loadFile() 59, 64 

loadPlugins() 437-438 



localeAwareCompare() 281, 395 

LocaleChange 401-402 

localeconv() 395 

lock() 411 

login() 332, 333 

long 489 

long long 489 

lrelease 402 

lupdate 402, 403 

M 



Mac OS X 

identifier la version 446 

installer Qt 479 
macEvent() 448 
macEventFilterO 448 
Macro 

de compilateur 446 

Q_ OBJECT 47 

Q_DECLARE_INTERFACE 
0 436 

Q_DECLARE_METATYP 

E() 284 
Q_EXPORT_PLUGIN2() 

121, 428, 441 
Q_INTERFACES() 120, 

439 

Q_OBJECT 17-18, 21, 

110, 390, 439 
Q_PROPERTY() 109 
qPrintable() 283, 289 
QT_TR_NOOP() 392 
QT_TRANSLATE_NOOP() 

393 

SIGNAL0 7, 23 

signals 17 

SLOT() 7, 23 

slots 17 
MagicNumber 86, 292 
mainSplitter 154 
MainWindow 399 

changeEvent() 401 

closeEvent() 74 



derivation de QMain Window 
47 

glisser-deposer 214 
newFile() 82 
sort() 69 

switchLanguage() 401 

updateStatusBar() 84 
make 5, 479 
Makefile 5, 22, 29 
Manipulateur de flux 295 
Masque 

AND 431 

XOR 431 
Matrice world 190 

dessin 188 
MDI (Multiple Document 

Interface) 75, 159 
Mecanisme 

des ressources 50 

fenetre-viewport 189 

parent-enfant 31 
MediumGap 204 
Memoire d'image 470 
Menu 

Bar() (QMainWindow) 53 
creer 51 
Edit 88 
File 57 
Options 92 
Tools 92 
Window 160 
message() 423 

metaObject(), declaration avec 

Q_OBJECT 25 
Meta-objets 25 
mid() 280, 283 
QString 66 
Migration de Motif/Xt et MFC 

vers Qt 444 
MIME (type) 215 
mimeDataO 224 
MinGW C++ 478 
minimumSizeHintO 124, 129, 

149 
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mirrored() 423 
Mise en veille 462 
mkdir() 239, 333 
moc 22, 25 

Mode de composition 188, 198 
Modele 

arborescence 242 

index 249 

liste 242 

personnalise 241 

predefini 236 

tableau 242 
modifiedO 80, 85 
modifiers() (QKeyEvent) 135 
Module 

QtCore 18 

QtGui 18 

QtNetwork 18 

QtOpenGL 18, 207 

QtSql 18 

QtSvg 18 

QtXml 18 
mouse 169, 208 
MouseButtonPress 170 
mouseMoveEvent() 117, 136, 
210 

mousePressEvent() 117, 136, 
170, 192, 210, 465 

QListWidget 217 

QWidget 116 
mouseReleaseEvent() 136, 139 

collage avec le bouton du 
milieu de la souris 225 
move() (QWidget) 72 
Move Action 218 
moveToThread() 419 
Multithread 407 
mutable 97, 101 
Mutex 411 

emploi 413 
MVC (Modele- Vue-Controleur) 
228 



N 



name() 120 
New 51 

newFile() 51, 58, 161, 166 
MainWindow 73, 82 

newPage() 199, 200, 205 

next() 267, 268 
map 275 

nextBlockSize() 344-345, 347, 
350 

nextSiblingO 369 
nmake 5 
NoBrush 187 
Node 250, 254 
nodeFromIndex() 253-254 
Noeud 251 

normalized() (QRect) 130, 133 
notify () (Q Application) 178 
number() (QString) 107 
numCopies() (QPrinter) 205 
numRowsAffected() 312 
numTicks 140 
numXTicks 125 
numYTicks 125 

o 



objectName 27 
Objet 

COM 448 

compare 68, 94 

QSettings 72 

SpreadsheetCompare 68 
offset 173, 174 
offsetOfO 250 

okToContinueO 58, 165, 167 

on_browseButton_clicked() 304 

on_convertButton_clicked() 304 

on_lineEdit_textChanged() 32 

Open 52 

Open source 478 

open() 59, 162, 166 

QTemporaryFile 307 



OpenGL 183, 207 

bibliotheque 207 
openRecentFile() 52, 64 
Operateur 

0 94 

+ 279 

+= 279 

. (point) 493 

: 486, 495 

« 486 

-> (fleche) 497 

bit a bit I 508 

bit a bitl= 508 

d' affectation 514 

sizeof() 502 

unaire & 497 

unaire * 499 
operator 291 
operator()(int) 95 
operator==() 274 
operator»() 291 
Ordre de tabulation 22, 28 
OvenTimer 191 

P 



Page d'accueil 75 

paginate() 202-203 

paint 113 

paintEngine() 445 

Painter, transformations 188 

paintEvent() 

anticrenelage 197 
copie de pixmap 136 
definition du viewport 194 
IconEditor 113 
implementation de event() 
170 

OvenTimer 192 
reimplementation 
TicTacToe 465 
widget Ticker 174 
paintGL() 208-209 
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palette() (QWidget) 115 
Parametre 

charset 224 

parent 244, 247 

preferredType 223 

section 245 

stocker 70 
parent 244, 247 
parentO (QModellndex) 242 
parse() 365 
parseEntry() 368 
Partage implicite 270 

principe 272 
paste() 90 
PATH 5, 380 
PdfFormat 199 
peek() 294, 429 
penColor() 109, 111, 113 
pendingDatagramSize() 357 
Pile 498 
Pile de zoom 

curZoom 127 

zoomStack 127 
Pilote 

QODBC 310 

QPSQL 310 

QSQLITE 310 

QSQLITE2 310 

QTDS 310 
Pinceau 185 

defond 188 

origine 188 
pixelRect() 116 

IconEditor 115 
pixmapO 224, 440 
Plastique 12 

PlotSettings 123, 125, 127, 139 

adjust() 134 
Plotter 122, 124 

keyPressEvent() 139 
Plug-in 119 

creation 425 

d'application 435, 439 

developpement de Qt 426 



plugins 122 
Pointeur 

a reticule 132 

C++ 497 

conteneur 252 

d'attente standard 86 

de fichier 288 

de noeud 256 

glisser-deposer 218 

nul 17 

QObject 64 

QPointer 498 

toupie 7 

hexadecimal 106 

vers la barre d'etat 56 

void 83 
Police 185 
Polymorphisme 493 
pop() 266 

populateListWidgetQ 437-438 
pos 100 
post() 339, 341 
postEvent() 423 
Preferred 149 
preferredType 223 
prepare() 312 
prepend() 62 
Preprocesseur 488, 520 
Presse-papiers 

de selection 224 

gerer 224 
previous() 268 

map 275 
printBox() 206 
printFlowerGuideO 202 
prinfHtmlO 201 
printlmageO 200 
prinfPagesO 202, 205 
PrintWindow 200 
pro (fichier) 122 
processEvents() (QApplication) 
179 

processNextDirectoryQ 335, 337 
processPendingDatagramsQ 356 



Programmation embarquee 469 
ProjectListWidget 216, 218 
Promotion 118 
propertyChanged() 455 
Protocole 

de transport 
TCP 329 
UDP 329 

QCOP 471 
Prototype de fonction 486 
push() 266 
put() 330, 333 

Q 



Q_ OBJECT 47 
Q_CLASSINFO() 459 
Q_DECLARE_INTERFACE() 
436 

Q_ENUMS() 449 
Q_EXPORT_PLUGIN2() 121, 
428 

Q_INTERFACES() 120, 439 
Q_OBJECT 17-18, 21, 110, 

390, 439 
Q_OS_UNIX 446 
Q_OS_WIN 446 
Q_PROPERTY() 109 
Q_WS_X11 446 
Q_WS_MAC 446 
Q_WS_QWS 446 
Q_WS_WIN 446 
qAbs() 278 

QAbstractltemDelegate 258 
QAbstractltemModel 244, 252 

reset() 246, 250 
QAbstractltemView 52, 156, 
218 

AnyKeyPressed 231 
ContiguousSelection 81, 89 
NoEditTriggers 233 
selectAll() 91 
setEditTriggers() 231 
QAbstractListModel 244 
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QAbstractScrollArea 42, 82, 156 
QAbstractSocket 342 

waitForDisconnected() 424 
QAbstractTableModel 244 
QAction 55, 162, 165, 171-172, 
374, 399, 400 

conversion d'un pointeur 
QObject 64 

setShortcutContextO 172 
QActionGroup 52, 162-163, 400 

triggered() 400 
qApp 53 

QApplication 4, 394, 418 
arguments() 168 
clipboardO 88, 224 
commitDataO 462 
exec() 178 

filtre d'evenement 177 
GuiServer 471 
isSessionRestored() 467 
notifyO 178 
processEvents() 179 
quit() 61 

setLayoutDirectionO 394 
setOverrideCursor() 132 
translate() 392 

QAssistantClient 379 
showPage() 380 

QAXAGGJUNKNOWN 456 

QAxAggregated 456 

QAxBase 449 

dynamicCallO 452 
generateDocumentation() 
451 

querylnterface() 452 
QAxBindable 453 
QAXCLASS0 459 
QAxContainer 448 

schema d'heritage 450 
QAXF ACTOR Y_BEGIN() 459 
QAXF ACTOR Y_DEFAULT() 

454, 457 
QAXF ACTOR Y_END() 459 



QAXFACTORY_EXPORT() 
459 

QAxObject 449 
QAxServer 448, 453 
qaxserver.def 457 
qaxserver.rc 457 
QAXTYPE0 459 
QAx Widget 449 

setControl() 451 
qBinaryFind() 264, 277 
QBitArray 431 
QBrush 116, 186 
QBuffer 86, 288 

fichiers a telecharger 339 
QByteArray 218-219, 222, 266, 

278, 288, 346, 352 
QCDEStyle 130 
QChar 386 

isDigit() 387 

isLetter() 387 

isLetterOrNumber() 387 

isLower() 387 

isMark() 387 

isNumber() 387 

isPrint() 387 

isPunct() 387 

isSpace() 387 

isSymbol() 387 

isUpper() 387 
QCheckBox 40, 147, 178 
QClipboard 

dataChanged() 225 

Selection 224 

setText() 88 
QCloseEvent, accept() 411 
QColor 111, 116 
QColorDialog 208 

getColor() 211 
QComboBox 158 

addltem() 241 

currentlndex() 68 
QComboBoxes 176 
qCompress() 294 
qconfig 472 



QCOP 471 
QCopChannel 471 
qCopy() 277 

QCoreApplication 330, 418 

addLibraryPath() 435 

arguments() 330 

postEvent() 423 

removePostedEvent() 423 
QDataStream 85-86, 288, 290, 
351, 431, 490 

numero de version 292 

operations TCP 342 

Qt_4_l 86 

skipRawData() 431 
QDate (toString) 395 
QDateEdit 395 
QDateTime 266 

currentDateTimeO 193 

toString 395 
QDateTimeEdit 395 
qDeleteAll() 252, 278 
QDesignerCustomWidget- 
Collectionlnterface 122 
QDesignerCustomWidget- 
Interface 119 

IconEditorPlugin 120 
QDialog 4, 16, 31, 178 

deriver 16 

exec() 66 

Rejected 66 
QDir 300, 301 

entry InfoList() 301 

entyList() 301 

exists() 301 

imageSpace() 301 

mkdir() 301 

rename() 301 

rmdir() 301 
QDirectPainter 471 
QDirModel 236, 238, 240 

mkdir() 239 
QDockWidget 157 

setFeatures() 157 
QDockWindow 157 
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QDomDocument 

documentElement() 367 

saveO 370 

setContent() 367 
QDomElement 369 
QDomNode 368 

firstChild() 369 

nextSibling() 369 

tagName() 368 

toElement 368 
QDoubleValidator 31 
QDrag 217 

startO 218 
QDragEnterEvent 218 
QEvent 170 

MouseButtonPress 170 

type() 170 
QFile 85-86, 288, 301, 336 

exists() 301 

remove() 301 
QFileDialog 

DontConfirmOverwrite 61 

getOpenFileName() 59 

getSaveFileName() 61 
QFilelnfo 301 
qFiUQ 277 
qFind() 276 
QFont 186, 288, 292 
QFontMetrics 174 

size() 174 
QFrame 41, 121 
QFtp 329 

cdO 333 

close() 333 

commandFinished() 333 
commandStarted() 333 
ConnectToHost 333 
done() 332 
ftpListInfo() 335 
get() 330, 333 
list() 333 
listInfo() 335 
login() 333 
mkdirO 333 



put() 330, 333 

rawCommand() 333 

readyRead() 339 

remove() 333 

rename() 333 

rmdir() 333 

stateChanged() 333 
qglClearColorO 209 
qglColor() 210 
QGLWidget 

dessin avec OpenGL 207 

qglClearColorO 209 

setFormat() 209 
QGridLayout 9, 19, 143, 146- 
147 

QGroupBox 178 
QHash 274 
QHash() 275 

QHBoxLayout 9, 19, 143, 146- 
147 

QHeaderView 82 
QHostlnfo 

fromName() 355 

lookupHost() 355 
QHttp 329 

done() 340, 342 

get() 339, 341 

getFile() 340 

head() 341 

httpDone() 340 

post() 339, 341 

QTcpSocket 341 

QtSslSocket 341 

read() 342 

readAll() 342 

readyRead() 342 

request() 341 

requestFinished() 342 

requestStarted() 342 

setHost() 341 

setUserO 341 
Qlcon 231 



Qlmage 111, 288, 427 

affichage de haute qualite 
197 

CompositionMode_Source- 
Over 198 

CompositionMode_Xor 199 

format ARGB32 premul- 
tiplie 197 

imprimer 199 

mirrored() 423 

rect() H7 

setPixelO 117 
QlmagelOHandler 428 
QlmagelOPlugin 427-428 
QlmageReader 427-428 
QlnputDialog 42 
QlntValidator 31 
QIODevice 287, 293 

ecrire dedans 300 

operations HTTP 341 

peek() 294, 429 

QBuffer 287 

QFile 287 

QProcess 287 

QTcpSocket 287 

QTemporaryFile 287 

QUdpSocket 287 

Readonly 87 

seek() 294 

unget-Char() 294 

WriteOnly 87 
QltemDelegate 258 

drawDisplay() 259 

drawFocus() 259 
QltemSelectionModel 324 
QKey Event 171, 177 

modifiers () 135 
QLabel 42 

boite de dialogue Find File 
147 

fenetre d'application 4 
Hello Qt 4 
implementation 108 
indicateurs d'etat 56 
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setText() 424 

statut de la derniere 
operation 343 
QLatinlStringO 393 
QLayout 146 

SetFixedSize 38 

setMarginO 147 

setSpacing() 147 
QLibrary 425 
QLineEdit 

activer avec barre d'espace 
175 

boite de dialogue Find File 
147 

entrees de donnees 42 
hasAcceptableInput() 32 
stacker une chaine de filtre 

240 
text() 66 

QLineEdits 355 

QList 274 

QListView 229, 237, 314 
QListWidget 39, 151, 228, 231, 
435 

glisser-deposer 215 
QListWidgetltem 231, 439 
QLocale 395 

SystemO 394 
qlonglong 490 
QMacStyle 130 

QMainWindow 4, 78, 144, 157 

deriver 46 

menuBarO 53 

statusBar() 56 
qmake 5, 21-22, 29, 479 
QMatrix 191 
qMax() 278 
QMenu 53 

addAction() 54 

addMenu() 54 
QMenuBar 4 
QMessageBox 

about() 70 

criticalO 59 



Default 58 

Escape 58 

informationO 59 

question() 59 

warningO 58, 70 
QMetaObject 25 

invokeMethod() 424 
QMimeData 213, 217 

conversion en TableMime- 
Data 224 

data() 219 

deriver 224 

glisser-deposer 219 

setData() 219 

text() 219 

urls() 215 
qMin() 194, 278 
QModellndex 237, 240, 245, 
253 

column() 242 

parent() 242 

row() 242 
QMotifStyle 130 
QMouseEvent 170 

buttons() 117 
QMovie 427 
qmPath 398 
QMultiMap 274 
QMutex 407, 409, 411, 416, 
423 

QMutexLocker 412, 423 
QObject 24, 266, 424, 439 

connectO 9, 419, 423 

deleteLater() 424 

disconnect) 423 

event() 170 

filtre d'evenement 177 

findChild() 40 

IconEditorPlugin 120 

killTimerO 175 

mecanisme parent-enfant 3 1 

moveToThread() 419 

QProcess 424 

QTimer 424 



sender() 64 

setPropertyO 451 

startTimer() 174 

tr() 18, 390 
qobject_cast() 64, 218, 224, 510 
QPaintDevice 445 
QPainter 114, 136, 183 

boundingRect() 204 

dessiner 184 

sur QPrinter 200 

draw...() 184 

drawLine() 114 

fillRectO 116 

imprimer 205 

programmation embarquee 
471 

rotate() 191 

scale() 191 

setCompositionModeQ 198 
shear() 191 

systeme de coordonnees 188 

translate() 191 
QPainterPath 186 
QPalette 115 

ColorGroup 115 

foreground() 115 
QPen 186 

QPixmap 124, 288, 439 
fill() 136 

QPlastiqueStyle 130 

QPluginLoader 438 

QPoint 1 14 

QPointer 498 

QPointF 138 

qPrintableO 289 

QPrintDialog 200 

choix de rimprimante 199 
options d'impression 205 
setEnabledOptions() 205 

QPrinter 200 

fromPage() et toPage() 205 
newPage() 199 
numCopies() 205 
setPrintProgramO 199 
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QProcess 86, 288, 303, 424 
execute() 307 
start© 305 

waitForFinished() 424 
QProgressBar 42, 343 
QProgressDialog 42, 179-180 
QPushButton 40 

clicked() 7 

effets 3D 187 

implementation 108 

repondre aux actions 
utilisateur 6 

setText() 39 

show() 11 

signal clicked() 170 
QRadioButton 40 
QReadLocker 413, 423 
QReadWriteLock 411, 413, 423 
QRect 115-117, 132 

contains() 117 

normalized() 130, 133 
QRegExp 104, 266 

PatternSyntax 241 
QRegExp Validator 31, 67, 107 
qRegisterMetaTypeStream- 

Operators<T>() 285 
qRgb() 111 
qRgba() 111 
QRubberBand 136 
QScrollArea 135, 144, 155-156 

viewport() 155 

widgets constitutifs 155 
QScrollBar 82 

QSemaphore 407, 41 1, 413, 423 
QSessionManager 463 
QSetting 291 
QSettings 71-72, 234 
QShortcut 172 

setContext() 172 
QSizePolicy 149 

Expanding 126, 149 

Fixed 149 

Ignored 149 

Maximum 149 



Minimum 112, 149 

MinimumExpanding 149 

Preferred 126, 149 
QSlider 7, 8 
qSort() 264, 277 
QSortFilterProxyModel 236, 240 
QSpinBox 7, 8, 106, 118, 158 

Acceptable 107 

Intermediate 107 

Invalid 107 

textFromValueO 107 

valueFromTextO 107 
QSpinBoxes 176 
QSplashScreen 75 
QSplitter 78, 144, 152, 159 

setSizes() 154 

sizes() 269 
QSqlDatabase 310-311, 313 
QSqlDriver 313 
QSqlQuery 310-312, 314 

firstO 312 

last() 312 

previous() 312 

seek() 312 
QSqlQueryModel 236 
QSqlRelationalDelegate 323 
QSqlRelationalTableModel 236, 
310 

formulaires 322 
QSqlTableModel 236, 310, 314- 
315, 319 

QSqlRelationalTableModel 
317 

qStableSortO 94-95, 278 
QStackedLayout 150 
QStackedWidget 39, 150-151 
QStackLayout 143 
QStatusBar 4 

addWidget() 57 
QString 

append() 279 

arg() 62, 392 



chaine 

de caracteres 507 

Unicode 387 
comparaison 277 
concatenation 279 
emploi comme conteneur 
278 

localeAwareCompareQ 395 

menu Edit 88 

mid() 66 

number() 107 

partage implicite 272 

replace() 221 

split() 90, 282 

sprintf() 279 

toInt() 66, 107 

toUpper() 107 

type de valeur 266 
QStringList 94, 168, 201 

arguments de ligne 
de commande 330 

concatenation 282 

fichiers a telecharger 338 

recentFiles 63 

takeFirst() 297 
QStringListModel 237, 240 
QStyle 130 

PE_FrameFocusRect 130 
QStyleOptionFocusRect 130 
QStylePainter 130 
qSwap() 250, 278 
Qt 

AlignHCenter 57 
BackgroundColorRole 242, 
256 

Caselnsensitive 17 
CaseSensitive 17 
classe d'elements 82 
DiagCrossPattern 187 
DisplayRole 231, 242 
EditRole 231, 242 
FontRole 242, 256 
IconRole 231 
ItemlsEditable 249 
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LeftDockWidgetArea 158 
mecanisme des ressources 
50 

NoBrush 187 
SolidPattern 187 
StatusTipRole 242 
StrongFocus 126 
systeme de meta-objets 25 
TextAlignmentRole 242, 
256 

TextColorRole 242, 256 
ToolTipRole 242 
UserRole 231 
WA_DeleteOnClose 166 
WA_GroupLeader 378 
WA_StaticContents 110 
WaitCursor 132 
WhatsThisRole 242 
Qt Designer 26 
creer 

des widgets person- 
nalises 108 
un formulaire 151 
editeur de connexions 37 
integrer des widgets person- 
nalises 118 
Qt Linguist 

execution 403 
presentation 403 
QtQuaterly 12 
Qt/Embedded 469 
Qt/Mac (installer) 479 
Qt/Windows (installer) 478 
Qt/X 11 (installer) 479 
qt_metacall(), declaration avec 

Q_OBJECT 25 
QT_TR_NOOP() 392 
QT_TRANSLATE_NOOP() 393 
QTableView 93, 229, 314, 320 
QTableWidget 78, 228, 232, 401 
ajouter le glisser-deposer 
219 

attributs QTableWidgetltem 
79 



deriver 78 

implementation 108 

operations TCP 343 

QHeaderView 82 

QScrollBar 82 

selectColumn() 91 

selectedRanges() 89 

selectRow() 91 

setCurrentCell() 66 

setltemO 84, 232 

setItemPrototype() 98 

sous classe Spreadsheet 49 

Track Editor 257 

widgets constitutifs 82 
QTableWidgetltem 79, 82, 90, 
222, 232, 235 

dataO 96, 99 

deriver 96 

text() 96 
QTableWidgetSelectionRange 
222 

QTabWidget 39, 41 
QtCore 18, 299 
QTcpServer 329, 342 
QTcpSocket 86, 288, 329, 341, 
342 

canReadLine() 352 
connected() 345, 346 
connectionClosedBySer- 

ver() 349 
disconnected() 349 
error() 349 
listen() 352 
readClient() 351 
readLine() 352 
readyRead() 347 
seek() 346 

updateTableWidget() 347 
write() 346 
QTDIR 122 

QTemporaryFile 288, 307 
QTextBrowser 42, 379 
moteur d'aide 376 
QTextCodec 388 



codecForName() 389 
setCodecForCStringsO 389 
setCodecForTr() 389, 403 

QTextDocument 202 

QTextEdit 42, 78, 149, 156, 307 
glisser-deposer 214 

QTextStream 86, 288, 294, 299, 
388 

AlignAccountingStyle 296 
AlignCenter 296 
AlignLeft 296 
AlignRight 296 
FixedNotation 296 
ForcePoint 296 
ForceSign 296 
internationalisation 388 
operations 

TCP 342 

XML 370 
readAll() 295 
readLine() 295 
ScientificNotation 296 
setRealNumberNotation() 
296 

SmartNotation 296 

UppercaseBase 296 

UppercaseDigits 296 
QtGui 18 
QThread 407 

currentThread() 417 

exec() 424 

run() 408 

terminate() 409 

wait() 411 
QThreadStorage 423 
QTime (toString) 395 
QTimeEdit 259, 323, 326 

Track Editor 260 
QTimer 175, 192, 424 

sendDatagram() 354 
QtNetwork 18 
QToolBar 4 
QToolBox 41 
QToolButton 40, 127, 158 
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QtOpenGL 18, 207 

Qtopia Core 469 

formats de police 473 
prise en charge de VNC 472 

Qtopia PDA 470 

Qtopia Phone 470 

Qtopia Platform 470 

QTranslator 398, 400, 404 
load() 394 

QTreeView 229, 239, 256 

QTreeWidget 39, 147, 149, 158, 
228, 233-234, 367 
fichier d'index 361 
operations XML 363, 365 

QTreeWidgetltem 369, 460 
operations XML 363 

QtSql 18 

QtSslSocket 341 

QtSvg 18 

qtTranslator 398, 401 
QtXml 18 

Qu'est-ce que c'est ? 375 
QUdpSocket 86, 288, 329, 353- 
354 

writeDatagramO 355 
querylnterface() 452, 456 
querySubObjectO 452 
question() (QMessageBox) 59 
QUiLaoder 39 
quint32 291 

quit() (QApplication) 61 
quitOnLastWindowClosed 61 
qUncompressO 294 
QUrl 334 
QUrllnfo 336 

QVariant 63, 71, 82, 99, 223, 
266, 278, 283, 288, 291, 312 
double 283 
int 283 
QBrush 283 
QColor 283, 284 
QCursor 283 
QDateTime 283 
QFont 283, 284 



Qlcon 284 
Qlmage 284 
QKeySequence 283 
QPalette 283 
QPen 283 
QPixmap 283, 284 
QPoint 283 
QRect 283 
QRegion 283 
QSize 283 
QString 283 
QVBoxLayout 9, 19, 143, 146, 
147 

QVector 124, 138 
qvfb 471 

QWaitCondition 407, 411, 416, 
423 

wait() 417 
QWhatThis, createAction() 376 
QWidget 7, 78 

changeEvent() 401 

close() 19, 61 

closeEvent() 47, 61 

contextMenuEvent() 55, 67 

deriver 108 

event() 171 

find() 444 

fontMetrics() 174 

geometryO 72 

mousePressEvent() 116 

move() 72 

paletteO 115 

QGLWidget 207 

repaint() 113 

resize() 72 

scroll() 175 

setCursor() 132 

setGeometry() 72 

setLayout() 9 

setMouseTracking() 117 

setStyle() 130 

setTabOrder() 22 

setToolTip() 374 

setWindowIconQ 49 



setWindowTitle() 8 

sizeHint() 20, 38, 57 

style() 130 

update() 112 

updateGeometry() 112 

windowModified 62 

winID() 444 
QWindowsStyle 130 
QWindowsXPStyle 130 
QWorkspace 78, 144, 159, 167 
QWriteLocker 413, 423 
QWS_DEPTH 472 
QWS_KE YB O ARD 471 
QWS_MOUSE_PROTO 471 
QWS_SIZE 472 
qwsEvent() 448 
qwsEventFilter() 448 
QWSServer 473 

qwsServer (variable globale) 473 
QXmlContentHandler 362, 365 

endElement() 360 

startElement() 360 
QXmlDeclHandler 360 
QXmlDefaultHandler 361-362 

errorStringO 363 
QXmlDTDHandler 360 
QXmlEntityResolver 360 
QXmlErrorHandler 360, 362, 
365 

QXmllnputSource 365 
QXmlLexicalHandler 360 
QXmlSimpleReader 360, 365 

R 



range.rightColumnO 68 
Rational PurifyPlus 490 
rawCommandO 333 
Reactivite et traitement intensif 

178 
read() 433 

QHttp 342 
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readAHO 295 

QHttp 342 

QIODevice 293 
readBitmap() 434 
readDatagram() 357 
readFile() 87 

Spreadsheet 60 
readHeaderlfNecessaryO 430, 
433 

readLine() 295, 297, 352 
Readonly (QIODevice) 87 
readRawBytes() 290, 291 
readSettingsO 49, 70-71, 155, 

234, 235 
readyRead() 339, 342, 344 
recalculate() 92, 93 
recentFileActions 52 
recentFiles 62, 63 
record() 327 
rect() (Qlmage) 117 
Reference 500 

refreshPixmapO 128, 131, 135 
refreshTrackViewHeader() 324, 
327 

regExpChanged() 256 
RegExpModel 250, 256 
RegExpParser 250, 256 
RegExpWindow 250 
Registre systeme 
enregistrement 

d'un serveur ActiveX 
460 

du serveur 457 
stockage des parametres 71 

regsvr32 457 

reinterpret_cast() 511 

reject() (QDialog) 31, 36 

release() 5, 456 

releaseDCO 445 

remove() 281, 333 
avec iterateur 268 

removeAll() 62 

removePostedEvents() 423 

removeRows() 237, 316 



rename() 333 
repaint() (QWidget) 113 
Repertoire (parcours) 300 
replace() 281 

QString 221 
Representation binaire des types 
86 

requestFinished() 342 
requestPropertyChange() 455 
requestStarted() 342 
Reseau 

envoi et reception de data- 
grammes UDP 353 
gestion 329 
programmer 

les application client/ 
serveur TCP 342 
les clients FTP 330 
les clients HTTP 339 
reserve() 275 

reset() (QAbstractltemModel) 

246, 250 
resize() (QWidget) 72, 127, 131 
resizeEvent() 131, 145, 146 
resizeGL() 208, 209 
resizelmage() 420 
ResizeTransaction 422 
Ressources (integration) 302 
restore(), matrice de transforma- 
tion 196 
restoreState() (QMainWindow) 
159 

retranslateUiO 397, 398 
retrieveData() 222, 223 
right() 280, 283 
rightSplitter 154 
rmdir() 333 
Role 231, 241 

DisplayRole 97 

EditRole 97 
rollback() 313 
rotate() 191, 196 
row() (QModellndex) 242 
rowCount() 82, 244 



rowSpan 148 
rubberBandlsShown 132 
rubberBandRect 132 
run() 422 

execution multi thread 408, 
409, 412 

S 



Sauvegarde 85 
save() 47, 52 

Editor 162 

fichier 60 

matrice de transformation 
196 

module de rendu 188 

operations XML 370 
saveAs() 47, 52, 60-61, 167 
saveFileO 60, 165, 167 
saveState() 463 

QMainWindow 159 
SAX (Simple API for XML) 359 
SaxHandler 362 
scale() 191 
Script configure 

-help 473 

Qtopia 470 
scroll() 139 

QWidget 175 
scrollTo() 239 

SDI (Single Document Interface) 
75 

section 245 

Securiser pour les scripts 456 
seek() 294 
SELECT 312 
Select All (action) 52 
selectColumn() 91 
selectedld() 230 
selectedRange() 89 
Selection 224 
selectionAsStringO 220 
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selectRowO 91 


reimplementation 247 


setPixel() (Qlmage) 117 


Semaphore 


setDefault() 19 


setPixmap() 


emploi 414 


setDirty() 93, 99 


presse-papiers 224 


freeSpace 414 


setDurationQ 193 


QDrag 218 


usedSpace 414 


setEditorData() 258, 260 


setPlotSettings() 127 


sendDatagram() 354 


seiEditTriggers() 233 


setPrintProgram() (QPrinter) 199 


sender() (QObject) 64 


QAbstractltemView 231 


setRadius() 455 


sendRequest() 346, 352 


setEnabledOptions() (QPrint- 


setRelationO 323, 325 


Separateur 152 


Dialog) 205 


setRenderHint() 186 


sessionFileName() 466 


setFeatures() (QDockWidget) 


setRootNode() 252 


sessionId() 467 


157 


setSelectionMode() 221 


sessionKeyO 467 


SetFixedSize (QLayout) 38 


setShortcutContext() (QAction) 


setAcceptDrops() 221 


setFocus() 165 


172 


setAllowedAreasO 158 


setFocusPolicyO 126 


setShowGrid() 80 


setAutoDetectUnicode() 388 


setFontO 186 


setSingleShot() 192 


setAutoFillBackground() 126 


setFormat() (QGLWidget) 209 


setSizePolicyO 110, 112, 126 


setAutoRecalculate() 93 


setFormulaO 84, 98, 298 


setSizes() (QSplitter) 154 


setBackgroundRoleQ 126, 136 


setGeometry() (QWidget) 72 


setSourceModel() 241 


setBitO 434 


setHorizontalHeaderLabels() 232 


setSpacingO (QLayout) 147 


setBrush() 186 


setHost() 341 


setSpeed() 455 


setByteOrder() 289 


setIconImage() 110, 112 


setStatusTipO 374 


setChecked() 163 


setlmage() 421 


setStretchFactor() 154 


setClipRect() 138 


presse-papiers 224 


setStyle() (QWidget ) 130 


setCodec() 295, 388 


setlmagePixelO 116, 117 


setTabOrder() (QWidget) 22 


setCodecForCStrings() 389 


SetInterfaceSafetyOptions() 456 


setText() 


setCodecForTr() 389 


setltem() 97 


code XML 369 


setColumnRange() 38, 68 


QTableWidget 84, 232 


presse-papiers 224 


SortDialog 69 


setItemPrototype() 81 


QClipboard 88 


setCompositionMode() 198 


QTableWidget 98 


QLabel 424 


setContext() (QShortcut) 172, 


setLayout() (QWidget) 9 


QPushButton 39 


367 


setLayoutDirection() 395 


widget Ticker 174 


setCurrentCellO 80 


setlocale() 395 


settings 235 


QTable Widget 66 


setMargin() (QLayout) 147 


setToolTipO 374 


setCurrentFileO 58, 60, 62, 165, 


setMessage() 408, 410 


setupUiO 29, 31, 304 


167 


setMimeDataO 224 


setValue() 9, 268, 276 


setCurrentIndex() 150-151 


setModal() 66 


setVisible() 36 


setCurrentRowO 151 


setModelData() 258 


setWidget() 155 


setCursor() 132 


setMouseTracking() (QWidget) 


setWidgetResizable() 156 


setCurveDataO 129 


117 


setWindowIcon() (QWidget) 49 


setData() 


setNum() 280 


setWindowModified() 166 


champ de base de donnees 


setOutputFormatO 199 


setWindowTitle() 62 


315 


setOverrideCursor() 132 


QWidget 8 


index de modele 316 


setPen() 115, 186 


setZoomFactor() 113 


QMimeData 219 


setPenColor() 112 


shear() 191 
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short 489 

Show Grid 52, 71, 75 

show() 65, 128, 165 

ShowControls 451 

showEvent() 173-174 

showPage() 379 

Signal 7 

clicked() 170, 237, 304- 

305, 348 
closeEditor() 260 
connected() 344-346 
connexion aux slots 23, 304 
contentsChanged() 166 
copyAvailable() 162 
currentCellChanged() 57 
currentRowChangedO 151 
description 22 
disconnected() 344, 349, 
350 

done() 331, 340, 342 
editingFinished() 259 
error() 344, 349 
findNextO 65 
findPrevious() 65 
finished() 422 
itemChanged() 81 
listlnfoO 335 
modified() 80, 85 
readyRead() 339, 342, 344, 

347, 351 
requestFinished() 342 
requestStarted() 342 
stateChanged() 333 
timeout() 192 
toggled 36 

transactionStarted() 423 
triggered() 51, 400 
valueChanged() 9 
versus evenement 170 
window ActivatedQ 161 

signals 7, 17, 23 

simplifiedO 282-283 

size() (QFontMetrics) 174 

sizeConstraint 38 



sizeHint (propriete) 35, 124, 129, 
150, 167, 465 

QWidget 20, 38, 57, 111 
sizeof() 502 
sizePolicy 112 
sizes() (QSplitter) 269 
skipRawData() 431 
Slot 7 

accept() 36 

addRow() 233 

allTransactionsDone() 420 

close() 19 

closeAHWindows() 74 
commitAndCloseEditorO 
259 

connectionClosedByServer() 
349 

connectToHost 345 
connectToServer() 345 
connexion aux signaux 23, 
304 

convertTolBit() 420 
convertTo3Bit() 420 
convertTo8Bit() 420 
copy() 88 

currentCdChanged() 324 
cut() 88, 163 
del() 90, 237 
description 22 
documentWasModifiedO 

166 
edit() 306 

enableFindButtonO 19, 21 
error() 349 
findClicked() 19, 21 
findNext() 91 
findPrevious() 92 
flipHorizontallyO 420 
flipVerticallyO 420 
ftpDone() 331 
ftpListInfo() 335 
help() 379 
httpDone() 340 
insert() 237 



newFile() 51, 58, 73, 161 
on_browseButton_clicked() 

304, 305 
on_convertButton_clicked() 

304 

on_lineEdit_textChanged() 
32 

on_objectName_signalName 

0 304 
open() 59 

openRecentFile() 64 
paste() 90 

processPendingDatagrams() 
356 

recalculate() 92 
refreshTrackViewHeader() 
327 

regExpChangedQ 256 
reject() 36 
resizelmage() 420 
save() 60, 162 
saveAs() 61 
selectAll() 52 
sendRequest() 346 
setAutoRecalculate() 93 
setColumnRange() 38 
setFocus() 165 
setValue() 9 
setVisible() 36 
show() 165 

somethingChanged() 81, 85 
Spreadsheet 65 
spreadsheetModified() 57 
stopSearch() 348 
switchLanguage() 400 
updateMenus() 163 
updateOutputTextEditO 306 
updateStatusBar() 57 
updateTableWidget() 347 
updateWindowTitleO 378 
zoomIn() 127 
zoomOut() 127 
Slot() 7, 23 
mot cle 17 
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SmallGap 204 
Socket 

QTcpSocket 341 

QtSslSocket 341 
SolidPattern 187 
somethingChanged() 81, 85, 93- 

94 
sort() 68 

MainWindow 69 

Spreadsheet 81 
SortDialog 68, 69 

setColumnRangeO 69 
Sorties 287 

source() (QDragEnterEvent) 218 
split() 282 

QString 90 
Spreadsheet 49, 65 

clear() 58 

readFile() 60 

setFormulaO 98 

sort() 68, 81 
SpreadsheetCompare 68, 81, 94 

arbre d'heritage 79 
spreadsheetModified() 57 
sprintfO 279 
Square 95 
squeeze() 275 
start() 

QDrag 218 

QProcess 305 

slot 455 
startDragO 217, 220 
startElementO 360, 364 
startOrStopThreadA() 410 
startOrStopThreadB() 411 
startPos 217 
starts With() 281 
startTimer() 174 
stateChanged() 333 
static_cast 510 
static_cast<T>() 64, 5 1 1 
statusQ 290 



statusBar() (QMain Window) 56 
StatusTipRole 242 
std 125 

STL (Standard Template Library) 
63 

fichiers d'en-tete 525 
Stockage 

de donnees en tant 
qu'elements 82 

des caracteres ASCII 490 

format 288 

local de thread 417 

XML 359 
stop() 408 

execution multithread 412 
stopped 408, 411 
stopSearch() 348 
strippedName() 62, 165 
strtodO 486 
Style 

de widget 12, 130 
Plastique 12 

specifique a la plate-forme 
12 

style() 130 
submitAll() 315 
sum() 104 

supportsSelection() 225 

Surcharge d'operateur 512 

switchLanguage() 400, 401 

Symbole 

de preprocesseur 446 

de systeme de fenetre 446 

Synchronisation (des threads) 41 1 

System() 394 

Systemes embarques 469 

T 



Table de hachage 274 

Tableau 

C++ 502 
d' octets 278 



TableMimeData 224 
tagNameO 368 
takeFirst() (QStringList) 297 
Tas 498 
tcpSocket 344 
TeamLeadersDialog 238 
terminate() 409 
Tetrahedron 208 
text() 27, 83, 137 

presse-papiers 224 

QLineEdit 66 

QTableWidgetltem 96 
TextAlignmentRole 99, 242, 

245, 256 
TextArtDialog 437-438 
TextArtlnterface 437-438 
TextColorRole 242, 256 
Texte 

ecriture 294 

lecture 294 
textFromValue() 107 
Thread 

communication 418 

consommateur 416 

creation 408 

producteur 416 

setMessage() 408 

stop() 408 

synchronisation 411 

utilisation des classes Qt 423 
ThreadDialog 410 
Ticker 172 
tidyFile() 298 
tile() 164 

timeout() 175, 192 
timer 169, 175 

timerEventO 173, 175, 181, 452 
title 34 
toAscii() 283 
toBack() 268 
toCsv() 221 
toDouble() 100, 280 
toElementO 368 
toggled() 36 
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toHtmlO 221 
toInt() 280 

QString 66, 107 
toLatinl() 283, 387 
toLongLongO 280 
toLower() 281, 283 
toolTip() 121 
ToolTipRole 242 
top() 266 

toPage() (QPrinter) 205 
toStringO 99, 284, 395 
toUpper() 281, 283 
QString 107 

tr() 

declaration avec Q_OB JECT 
25 

internationalisation 392 
traduction de litteraux 18 

Trace de dessin 187 

TrackDelegate 258, 323, 326 

transactionO 313, 422 

ajout a la file d'attente 421 
ConvertDepthTransaction 
422 

executions simultanees 314 

FlipTransaction 422 

ResizeTransaction 422 

SQL 313 
transactionStarted() 422, 423 
TransactionThread 420 

runQ 423 
translate() 191, 392-393 
triggered() 51 
trimmedO 282, 283 
TripPlanner 344 
TripServer 349 

incomingConnection() 349 
truncate() 272 
type() 284 

conversions 509 

MIME 215 

personnalise de glisser 219 
primitifs 489 



QEvent 170 

representation binaire 86 
valeur 514 
TypeDef 509 

u 



UDP 329 

datagrammes 353 

ecoute du port 355 

envoi et reception de data- 
grammes 353 
uic 29, 32, 120 
unget-Char() 294 
unicode() 386-387 
Unite de compilation 484 
unlockO 411 
unsigned 489 
update() 

forcer un evenement paint 
113 

planifier un evenement paint 
136 

QRect 117 

QWidget 112 

viewport 93 
updateGeometryO 113, 174 

QWidget 112 
updateGL() 211 
updateMenus() 163 
updateOutputTexfEditO 306 
updateRecentFileActionsO 62, 
74-75 

updateRubberBand() 136 
updateRubberBandRegion() 132 
updateStatusBar() 57 
MainWindow 84 
updateTableWidget() 348 
updateWindowTitle() 378 
UserRole 231 
using namespace 486 
uuidgen 457 
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Valeur 71 

bitsPerPixel 431 

compression 431 
Valgrind 490 
Validateur 

QDouble Validator 31 

QlntValidator 31 

QRegExpValidator 31 
value() 

champ de base de donnees 
312, 314 

courbe 138 

iterateur STL 276 

map 274, 275 

valeur 

d'une cellule 100 
d'une map 275 
valueChanged() 9 
valueFromTextO 107 
values() 274 
Variable 

globale 516 

mutable 97 

sur la pile 67 
Variable d'environnement 

LD_LIBRARY_PATH 481 

PATH 5, 380 

QTDIR 122 

QWS_KEYBOARD 471 

QWS_MOUSE_PROTO 
471 
Variant 278 
Vecteur 

d' elements 264 

de coordonnees 122 

de QChar 279 

distances 248 

initialisation 277 

parcourir 265 
Version de systeme d'exploitation 
446 
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viewport^) 155 
dessin 188 
OpenGL 209 

sy steme de coordonnees 189 
transformation du painter 

194 
update() 93 
widget 82 
virtual 494 

VNC (Virtual Network 

Computing) 472 
void* 511 
Vue 

QListView 229 
QTableView 229 
QTreeView 229 

w 



WA_DeleteOnClose 74, 162, 
166 

WA_GroupLeader 378 
WA_StaticContents 117 
wait() 411, 417 
waitForDisconnected() 424 
waitForFinished() 424 
warning() (QMessageBox) 58, 
70 

WeatherBalloon 354 
whatsThis() 121 
WhatsThisRole 242 
wheel 135 
wheelEvent() 135 
while 179 
Widget 

ancrable 157 



bouton 40 

QCheckBox 40 
QPushButton 40 
QRadioButton 40 
QToolButton 40 

central 78 

classes 40 

compagnon 18 

conteneur 41 

multipage 41 
QFrame 41 
QTabWidget 41 
QToolBox 41 

d'affichage d' elements 41 

d' entree 43 

definition 4 

disposer 7, 28, 144 

HelpBrowser 377 

OvenTimer 191, 194 

palette de couleurs 115 

personnalise 106 
creer 105 

et Qt Designer 108 
integrer avec 
le Qt Designer 118 

Plotter 122 

style 12 

viewport 82 
window ActivatedQ 161 
windowModified 57, 62 
Windows 

ActiveX 448 

identifier la version 446 

installer Qt 478 

Media Player 449 
windowTitle 27 
winEvent() 448 
winEventFilter() 448 



winld() 444 
write() 429 

QIODevice 293 
writeDatagram() 355 
writeFile() 85 
WriteOnly (QIODevice) 87 
writeRawBytes() 290 
writeSettingsO 70, 71, 154 

X 



X Render 197 
Xll 

gestion de session 461 

installer Qt 479 
xllEvent() 448 
xllEventFilter() 446 
Xcode Tools 479 
XML 359 

ecriture 370 

lecture 

avec DOM 365 
avec SAX 360 

xsm 467 

z 



Zone 

d'action 188 
deroulante 155 

zoomFactoi'O 109, 113 

zoomlnO 127, 134 

zoomOut() 127 

zoomStack 127 
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Un ouvrage unique sur le developpement d'interfaces 
graphiques avec la biblioheque Qt, ecrit par des specia- 
listes de Trolltech. 

Grace au framework Qt de Trolltech, vous pouvez creer des 
applications C++ de niveau professionnel qui s'executent 
en natif sous Windows, Linux/UNIX, Mac OS 10 et Linux 
integre sans qu'aucune modification dans le code source 
soit necessaire. 

Ce guide complet vous permettra d'obtenir des resultats 
fantastiques avec la version la plus puissante de QT jamais 
creee : QT 4.1 . En s'appuyant sur des exemples realistes, 
il presente des techniques avancees sur divers sujets depuis 
le developpement de I'interface graphique de base d I'inte- 
gration avancee de XML et des bases de donnees. 

• Couvre I'ensemble des elements fondamentaux de Qt, 
depuis les boTtes de dialogue et les fenetres jusqu'd I'im- 
plementation de la fonctionnalite d'une application 

• Presente des techniques avancees que vous ne retrouve- 
rez dans aucun autre ouvrage, comme la creation de 
plugins d'application et pour Qt, ou la creation d'interfa- 
ces avec les API natives 

• Contient des annexes detaillees sur la programmation 
C++/Qt destinee aux developpeurs Java experiments 
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•XML 

•Aide en ligne 
Partie III : Qt : niveau avance 

• Internationalisation 

• Environnement multithread 
•Creer des plug-in 

• Fonctionnalites specifiques d la 
plate-forme 

•Programmation embarquee 
Annexes 
•Installer Qt 

•Introduction au langage C++ 
pour les programmeurs Java 
etC# 
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